Run Titan Agent on Windows Home

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

1. 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

• 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

1. Open CMD as administrator.

2. Type: multipass --version

Success if version number appears.

Step 3: Install and Run Titan Agent

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:

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:

Titan Network

1. Login to Titan account

2. Find and copy your key

4. Run Titan Agent

1. Open CMD as administrator:

• Press Windows key

• Type "cmd"

• Right-click "Command Prompt"

• Select "Run as administrator"

1. Navigate to Titan-Agent folder:

cd your-titan-agent-folder-path

1. Start Agent:

Copy following command

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

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

Common Issues

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

• Select and download corresponding version

• Install Visual C++

• Run VirtualBox installer again