Installer l'agent

Introduction

L’agent Gward est un binaire ultra-léger développé en Go (~10 Mo RAM, ~10 Mo binaire). Il fonctionne en mode stateless et reprend automatiquement après une reconnexion.

Prérequis

Droits d’administration sur la machine cible
Accès réseau sortant vers la plateforme Gward

Étapes

1. Télécharger le binaire

Depuis la plateforme Gward, section Agents > Ajouter un agent, téléchargez le binaire adapté à votre OS.

2. Installation sur Linux

chmod +x gward-agent
sudo mv gward-agent /usr/local/bin/gward-agent

Créez un service systemd pour démarrer l’agent automatiquement :

[Unit]
Description=Gward Agent
After=network.target

[Service]
ExecStart=/usr/local/bin/gward-agent --token=VOTRE_TOKEN
Restart=always

[Install]
WantedBy=multi-user.target

sudo systemctl enable gward-agent
sudo systemctl start gward-agent

3. Installation sur Windows

Lancez le binaire .exe en tant qu’administrateur ou enregistrez-le comme service Windows :

gward-agent.exe --token=VOTRE_TOKEN --install-service

4. Installation sur macOS

chmod +x gward-agent
sudo mv gward-agent /usr/local/bin/gward-agent
gward-agent --token=VOTRE_TOKEN

5. Vérifier que l’agent est connecté

L’agent apparaît dans la liste des agents de la plateforme avec le statut online dans les quelques secondes suivant le démarrage.

Résultat attendu

L’agent est démarré, connecté à la plateforme et visible dans la liste des agents.