# (CLI)Intall Titan Agent on Windows Home

{% hint style="success" %}
**High Earnings Guide:**\
1\. New nodes require a 3–7 day deployment period. Please be patient—earnings will gradually stabilize after this phase.\
2\. Keep your device online 24/7, especially during evening peak hours (18:00–24:00 UTC+8).\
3\. Ensure both Agent status and Service status show as normal. If any issues occur, contact customer support promptly.\
[→ Click for more tips](https://help.titanapp.info/titan-network-en/galileo-testnet/f.a.q./how-to-increase-node-rewards)
{% endhint %}

## Step 1: Install VirtualBox

*For Windows Home Edition or other versions that don't support Hyper-V services, you'll need to download VirtualBox as the virtual machine driver for Multipass.*

### 1. Download VirtualBox

1. Open your preferred browser (Chrome, Edge, etc.)
2. Visit VirtualBox official website: <https://www.virtualbox.org/wiki/Downloads>

Alternative URL: <https://www.oracle.com/hk/virtualization/technologies/vm/downloads/virtualbox-downloads.html>

3. Click "Windows hosts" to download the Windows installation package

### 2. Install VirtualBox

1. Locate and double-click the downloaded VirtualBox installation file (like VirtualBox-7.0.xx-Win.exe)
2. Double-click the package to start installation
3. Select installation location

* If prompted about network features, click "Yes"
* Finally click "Finish"

### 3. Verify Installation

1. Open Command Prompt
   1. Press Windows key + R
   2. Type cmd and press Enter
2. In the black window, type:

```
VBoxManage --version
```

If it displays a version number like 7.0.xx, installation was successful

## Step 2: Download and Install Multipass

#### **1. Download Multipass**

* Visit [Multipass official website](https://canonical.com/multipass/install)
* Select **Windows** page
* Click "**Download Multipass for Windows**" for multipass-\<version>+win-win64.msi installer

#### **2. Install Multipass**

* Double-click .msi file
* Click "Next"
* Accept license agreement
* Select "Add multipass to the current user's PATH"
* Choose installation directory
* Click "Install"

#### **3. Verify Installation**&#x20;

1. Open CMD as administrator.&#x20;
2. Type: `multipass --version`&#x20;

Success if version number appears.

## Step 3: Install and Run Titan Agent&#x20;

> Note: While demonstrated on desktop, installing on D: or E: SSD is recommended, avoid C: drive or desktop.

### **1. Download Titan Agent**

* Open browser
* Visit:&#x20;

{% embed url="<https://pcdn.titannet.io/test4/bin/agent-windows.zip>" %}

* Wait for download to complete

### 2. Extract Files

Create "titan-agent" folder on desktop

1. Right-click on your desktop
2. Choose "New folder"
3. Name it "titan-agent"
4. Extract `agent-windows.zip` and move all files into "titan-agent" folder

### 3. Get Key

1. Visit:

{% embed url="<https://test4.titannet.io>" %}

1. Login to Titan account
2. Find and copy your key

### 4. Run Titan Agent&#x20;

1. Open CMD as administrator:

* Press Windows key
* Type "cmd"
* Right-click "Command Prompt"
* Select "Run as administrator"

2. Navigate to Titan-Agent folder:&#x20;

```
cd your-titan-agent-folder-path
```

3. Start Agent:

Copy following command

{% code overflow="wrap" %}

```
agent.exe --working-dir="your-titan-agent-folder-path" --server-url=https://test4-api.titannet.io --key=your-key
```

{% endcode %}

* Replace "your-titan-agent-folder-path" and "your-key" with actual values.

## Common Issues&#x20;

VirtualBox Installation Error Solution:

* Open browser, visit: <https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170>
* Click [Visual Studio 2015, 2017, 2019, and 2022](https://learn.microsoft.com/zh-cn/cpp/windows/latest-supported-vc-redist?view=msvc-170#visual-studio-2015-2017-2019-and-2022)
* Select and download corresponding version
* Install Visual C++
* Run VirtualBox installer again

📢Acknowledgments

🤩We extend our thanks to community volunteer <mark style="color:purple;">**Bohan**</mark> for translating this document in February 2025.