# (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](/titan-network-en/galileo-testnet/f.a.q./how-to-increase-node-rewards.md)
{% 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://titannet.gitbook.io/titan-network-en/galileo-testnet/titan-agent-installation-guide/windows/cli-intall-titan-agent-on-windows-home.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.