# Cloud VPS

{% hint style="warning" %}
⚠️Important Notice - Please carefully read the following precautions before deployment:

🛜 Network Reminder:
\
NAT 1 network is recommended. For NAT 3 or 4 networks, it is essential to enable IPv6.

🛑 **Security Risk Warning**

* This deployment method requires root access to your VPS
* It will run directly on your VPS and may affect system configuration
  * <mark style="color:red;">**During resource usage, your system password may be modified**</mark>
* This operation may affect your control over the VPS
* Only recommended for use on fully controlled VPS systems
* If you have security concerns, please choose alternative deployment methods

👤 **This guide is only applicable to**

* Users familiar with Linux command line operations
* Users who understand the purpose of each operational step
* Users who understand the scope and impact of root privileges
* ⚠️ If you are unfamiliar with the above, it is strongly recommended to seek technical assistance

{% endhint %}

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

## Environment Requirements

* VPS server with internet access
* System administrator (Root) privileges
* Ensure wget and unzip commands are installed
  * If not installed, run: `sudo apt-get install wget unzip` (Ubuntu/Debian systems)
  * Or run: `sudo yum install wget unzip` (CentOS systems)

## Deployment Steps

### 1. Download and Extract Installation Package

```bash
# Enter the following commands in terminal (press Enter after each line):

# Download installation package
wget https://pcdn.titannet.io/test4/bin/agent-linux.zip
# If download fails, check your network connection

# Create installation directory (add sudo if permission denied)
mkdir -p /opt/titanagent

# Extract installation package to specified directory
unzip agent-linux.zip -d /opt/titanagent
# If unzip command not found, install unzip first
```

⚠️ Note:

* Wait for each command to complete before executing the next
* If you see "Permission denied", add sudo before the command
* Ensure each command executes successfully before proceeding

### 2. Get Key

### 3. Start Service

<pre class="language-bash"><code class="lang-bash"># Enter installation directory
cd /opt/titanagent
<strong>
</strong><strong># Run Agent (replace the following two items)
</strong>./agent --working-dir=/opt/titanagent --server-url=https://test4-api.titannet.io --channel=vps --key=YOUR_COPIED_KEY
</code></pre>

### Common Issues

<details>

<summary>Error: "command not found"</summary>

* Verify you are running commands in the correct directory
* Use the `ls` command to check files in the current directory
* Ensure filenames are entered correctly, paying attention to case sensitivity

</details>

<details>

<summary>Error: "Permission denied"</summary>

* Add `sudo` before the command, for example: `sudo ./agent ...`
* The system will ask for your password, this is normal
* When entering the password, characters won't be displayed - just type it and press Enter

</details>

<details>

<summary>Network errors</summary>

* Check if your computer is connected to the network
* Try accessing other websites to confirm network connectivity
* If using a proxy, verify your proxy settings

</details>

<details>

<summary>Wrong key</summary>

* Check if the key was copied completely
* Verify there are no extra spaces in the key

</details>


---

# 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/cloud-vps.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.