Installer l'agent

Prérequis

• Un VPS ou une machine dédiée que vous contrôlez.
• Windows : Windows Server 2019 ou plus récent, ou Windows 10/11, avec un accès administrateur.
• Linux : Debian 11+, Ubuntu 20.04+, ou RHEL/Fedora avec apt ou dnf, avec un accès root ou sudo.
• Un accès Internet sortant : l'agent communique avec Servitium en HTTPS. Vous n'avez aucun port entrant à ouvrir pour le panneau.
• L'e-mail et le mot de passe de votre compte Servitium.

Installation sur Windows

1. Faites un clic droit sur le menu Démarrer et choisissez Windows PowerShell (Admin) ou Terminal (Admin).
2. Collez la commande ci-dessous. La page d'installation du Center l'affiche avec votre propre e-mail déjà renseigné. Remplacez l'adresse d'exemple si vous la copiez depuis cette page.
3. PowerShell vous demande le mot de passe de votre compte Servitium. Saisissez-le et appuyez sur Entrée.

iwr -useb https://api.servitium.org/downloads/client/v1/setup.ps1 -OutFile $env:TEMP\setup.ps1; & $env:TEMP\setup.ps1 -Email your-email@example.com

L'installateur télécharge l'agent (environ 76 Mo) et prend environ 3 à 5 minutes sur une machine neuve.

Installation sur Linux

1. Connectez-vous à la machine en SSH et vérifiez que vous pouvez utiliser sudo (ou connectez-vous en root).
2. Exécutez la commande ci-dessous.
3. L'installateur vous demande votre e-mail et votre mot de passe Servitium de manière interactive. C'est le même compte que celui du Center.

curl -fsSL https://api.servitium.org/downloads/client/v1/setup.sh | sudo -E bash

Sur une machine neuve, cela prend environ 2 à 4 minutes.

Ce que fait l'installateur

Sur Windows, l'installateur :

• Télécharge l'agent dans son propre dossier.
• Installe le runtime Visual C++ et les composants du runtime DirectX dont Conan Exiles a besoin, s'ils sont absents.
• Ajoute une exclusion Windows Defender pour le dossier de l'agent.
• Enregistre la machine sur votre compte.
• Installe le service Windows Servitium Monitor. Il démarre avec Windows et redémarre tout seul s'il s'arrête.

Sur Linux, l'installateur :

• Installe les paquets système dont l'agent et SteamCMD ont besoin (apt ou dnf).
• Télécharge l'agent et enregistre la machine sur votre compte.
• Si le pare-feu ufw est installé, autorise l'agent à ouvrir automatiquement les ports de jeu.
• Crée le service systemd servitium-monitor, activé au démarrage.

Vous pouvez relancer l'installateur sans risque : il met l'agent à jour sur place et conserve l'identité de votre hôte.

Vérifier que l'hôte apparaît

Dans le Center, ouvrez Admin, Hosts. Votre machine devrait apparaître en 30 secondes environ. Sur la page d'installation, Rechercher mon hôte la guette pendant environ deux minutes et confirme dès qu'elle est connectée.

Si elle n'apparaît pas, vérifiez le service sur la machine :

Get-Service ServitiumMonitor

Get-Content C:\Servitium\logs\service-*.log -Tail 50

sudo systemctl status servitium-monitor

sudo journalctl -u servitium-monitor -f

Une fois l'hôte en ligne, choisissez Ajouter un serveur de jeu sur la page Hosts pour rattacher votre serveur. D'autres solutions se trouvent dans FAQ et dépannage.

Mettre à jour l'agent

Pour mettre à jour l'agent, relancez la même commande d'installation. Elle remplace le programme, conserve vos réglages et l'identité de l'hôte, puis redémarre le service. Vos serveurs de jeu et leurs fichiers ne sont pas touchés.

Désinstallation

Sur Windows, lancez le programme de désinstallation depuis un PowerShell administrateur. Il supprime le service, arrête les serveurs de jeu qu'il faisait tourner, efface les dossiers de l'agent et retire les règles de pare-feu qu'il avait créées. Les fichiers de vos serveurs de jeu sont conservés, sauf si vous ajoutez -WipeServers (et -WipeSteam pour supprimer aussi SteamCMD).

iwr -useb https://api.servitium.org/downloads/client/v1/uninstall.ps1 -OutFile $env:TEMP\uninstall.ps1; & $env:TEMP\uninstall.ps1

Sur Linux, arrêtez et supprimez le service et le programme de l'agent :

sudo systemctl disable --now servitium-monitor
sudo rm /etc/systemd/system/servitium-monitor.service /opt/servitium/servitium-monitor
sudo rm -f /etc/sudoers.d/servitium-monitor
sudo systemctl daemon-reload

Enfin, dans le Center, ouvrez l'hôte dans Admin, Hosts et utilisez Supprimer ce host. Les serveurs qui lui étaient rattachés ne sont plus assignés, mais ils ne sont pas supprimés. Si l'agent tourne encore quelque part, il se réenregistre à sa prochaine connexion.