> 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/titan-fil/titan-fil-agent-installation-guide/linux/install-titan-agent-on-linux-x86.md).

# Install Titan Agent on Linux (x86)

{% 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 %}

## Preparation

#### System Requirement

* Supported OS: Ubuntu, Debain, Fedora, CentOS/RHEL
* Hardware architechture: x86/x64
* Minimum configuration requirements:
  * CPU: 2 Cores
  * Memory: 4GB
  * Hard Disk: 50GB available space

## Step 1: Multipass Installation Steps

1. **Check if Snap is Installed**

First, ensure your Linux system has Snap installed. Most modern Linux distributions (like Ubuntu, Debian, Fedora, etc.) support Snap by default. Open terminal (press Ctrl + Alt + T) and enter: `snap --version`

* If version information displays, it's installed - skip to step 3 
* If you see "`command not found`", you need to install Snap

2. **Install Snap** 

Choose your system and run the corresponding command:

**Ubuntu/Debian users:**

```bash
sudo apt update
sudo apt install snapd
```

**Fedora users:**

```bash
sudo dnf install snapd
```

**CentOS/RHEL users:**

```bash
sudo yum install snapd
```

**Enable Snap after installation:**

```bash
sudo systemctl enable --now snapd.socket
```

3. **Install Multipass**

```bash
sudo snap install multipass
```

* Wait for installation to complete

4. **Verify Installation**

```bash
multipass --version
```

* Seeing a version number means successful installation!

> Having Issues?
>
> * Command not working? Try adding 'sudo'
> * Slow download? Check network and retry
> * Installation interrupted? Run command again

## Step 2: Installing and Running Titan Agent

### 1. Download and Extract Installation Package

```bash
# Download installation package
wget https://pcdn.titannet.io/filpcdn/bin/filagent/filagent-linux.zip

# Create installation directory
mkdir -p /opt/filtitanagent

# Extract installation package
unzip filagent-linux.zip -d /opt/filtitanagent
```

### 2. Get Your Key

1. Open browser and visit:<https://filecoin.titannet.io/>
2. Log into your Titan account
3. Find and copy your key
4. Run the Program

{% code overflow="wrap" %}

```bash
cd /opt/titanagent

# Run FIL Agent (remember to replace <YOUR_KEY>)
./filagent --working-dir=<your-titan-agent-folder-path> --server-url=https://fil-agent-server-api.titannet.io --key=<your-key>
```

{% endcode %}

* Replace "your-titan-agent-folder-path" with actual folder location
* Replace "your-key" with the key you copied earlier

**Common Issues**

* Download failed? Check network connection
* Extraction error? Ensure unzip is installed: `apt install unzip` or `yum install unzip`
* Insufficient permissions? Use sudo to run commands
* Program won't run? Add execution permission: `chmod +x agent`

**Tip**

* Recommended to set up the program as a system service for auto-start on boot


---

# 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/titan-fil/titan-fil-agent-installation-guide/linux/install-titan-agent-on-linux-x86.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.