# Install Titan Agent on macOS

{% 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 Multipass&#x20;

### Method 1: Direct Download (Recommended 👍)

1. Visit \[[Multipass download page](https://canonical.com/multipass/install)]
2. Click to download the macOS installer
3. Open the downloaded .dmg file
4. Follow the prompts and click Next to install

### Method 2: Install Multipass via Homebrew&#x20;

If you prefer using Homebrew (macOS package manager) to install Multipass, follow these steps:

1. Check if Homebrew is installed

```
brew --version
```

If you see a version number, skip to step 3. Otherwise, continue to step 2.

2. Install Homebrew

```
bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```

3. Install Multipass

```
brew install --cask multipass
```

4. Verify Installation

```
multipass --version
```

Seeing a version number means the installation was successful!

## Step 2: Install and Run Titan Agent

### 1. Download the Package

1. Open your browser
2. Visit download link:

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

1. Wait for download to complete

### 2. Extract the Program

1. Open Finder
2. Go to Downloads folder
3. Find agent-darwin.zip
4. Double-click to extract

### 3. Get Your Key

1. Open browser and visit:&#x20;

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

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

### 4. Run the Program

1. Open Terminal
   1. Press Command + Space
   2. Type "terminal" and press Enter
2. Enter and run the command:&#x20;

* Copy the following command (remember to replace the relevant information):

```
./agent --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.


---

# 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://help.titanapp.info/titan-network-en/galileo-testnet/titan-agent-installation-guide/macos/install-titan-agent-on-macos.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.
