> For the complete documentation index, see [llms.txt](https://help.titanapp.info/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.titanapp.info/titan-network-en/galileo-testnet/titan-agent-installation-guide/macos/install-titan-agent-on-macos.md).

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

## Step 1: Install Multipass 

### 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 

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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` 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>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.