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

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.

Version: 1.0 Last Updated: 2026-03-19 Source:

giipv3/public/help/agent-setup-linux.en.md