Linux Agent Setup Guide

Learn how to install the GIIP agent on a Linux server to start management.

📋 Overview

The GIIP Linux agent is provided in a lightweight and powerful binary format, supporting all major distributions including Ubuntu, CentOS, Debian, and RHEL. Installation and service registration are completed with a single line of command.

🛠️ Prerequisites

• Operating System: 64-bit Linux (Kernel 3.10 or later recommended)
• Permissions: sudo or root privileges required
• Authentication Info: Prepare your CSN, Access Key (AK), and Secret Key (SK) from the [My Profile] menu on the GIIP console in advance.

🚀 Installation Steps

1. Run Installation Script

Open a terminal and run the following command. (Use the unique installation address copied from the GIIP console)

wget -O install_giip.sh https://api.giip.io/download/agent/linux/install.sh
chmod +x install_giip.sh
sudo ./install_giip.sh --csn=[CSN] --ak=[AK] --sk=[SK]

2. Verify Installation Options

• Auto-start: The installation script automatically registers the agent as a systemd service.
• Path: The default installation path is /opt/giip-agent.

🔍 Verification

1. Verify Service Status

Check if the agent is running normally using the following command:

systemctl status giip-agent

An active (running) status indicates normal operation.

2. Console Check

Verify if the corresponding server's hostname and IP appear and its status is Online in the [Server List] on the GIIP web console.

🛠️ Manual Configuration Changes

If authentication keys have changed or you need to add proxy settings, modify the configuration file at the following path:

• File Path: /opt/giip-agent/config.yaml
• Restart service after modification: sudo systemctl restart giip-agent

💡 Important Notes

• Port 443 (HTTPS) must be open for external communication.
• wget or curl must be installed.

🔧 Troubleshooting

Symptom	Cause	Solution
systemctl status giip-agent does not show active (running)	Authentication info (CSN/AK/SK) in config.yaml is incorrect	Check and fix /opt/giip-agent/config.yaml, then run sudo systemctl restart giip-agent
command not found error while running the install script	wget or curl is not installed	Install wget or curl first via your distribution's package manager
Permission denied during installation	Ran without sudo or root privileges	Re-run with administrator privileges as sudo ./install_giip.sh ...
Server does not appear as Online in the console [Server List]	Outbound port 443 (HTTPS) is blocked	Open port 443 in the firewall and restart with sudo systemctl restart giip-agent

---

Version: 1.0 Last Updated: 2026-03-19 Source: giipv3/public/help/agent-setup-linux.en.md