Cloud VPS

⚠️ Important Notice - Must Read Before Use

Please carefully read the following notes before starting deployment:

🛑 Security Risk Warning

  • This deployment method requires root access to your VPS

  • It will run directly on your VPS and may affect system configuration

    • During resource usage, your system password may be modified

  • 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

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

# 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

# Enter installation directory
cd /opt/titanagent

# Run Agent (replace the following two items)
./agent --working-dir=/opt/titanagent --server-url=https://test4-api.titannet.io --channel=vps --key=YOUR_COPIED_KEY

Common Issues

Error: "command not found"
  • 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

Error: "Permission denied"
  • 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

Network errors
  • 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

Wrong key
  • Check if the key was copied completely

  • Verify there are no extra spaces in the key

Last updated