Agent installieren

Voraussetzungen

• Ein VPS oder eine dedizierte Maschine, die du selbst verwaltest.
• Windows: Windows Server 2019 oder neuer bzw. Windows 10/11, mit Administratorzugriff.
• Linux: Debian 11+, Ubuntu 20.04+ oder RHEL/Fedora mit apt oder dnf, mit Root- oder sudo-Zugriff.
• Ausgehender Internetzugang: Der Agent kommuniziert über HTTPS mit Servitium. Für das Panel musst du keinen eingehenden Port öffnen.
• Die E-Mail-Adresse und das Passwort deines Servitium-Kontos.

Installation unter Windows

1. Klicke mit der rechten Maustaste auf das Startmenü und wähle Windows PowerShell (Administrator) oder Terminal (Administrator).
2. Füge den folgenden Befehl ein. Auf der Installationsseite im Center ist deine eigene E-Mail-Adresse bereits eingetragen. Wenn du ihn von hier kopierst, ersetze die Beispieladresse.
3. PowerShell fragt nach dem Passwort deines Servitium-Kontos. Gib es ein und drücke die Eingabetaste.

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

Der Installer lädt den Agent herunter (etwa 76 MB) und benötigt auf einer frischen Maschine etwa 3 bis 5 Minuten.

Installation unter Linux

1. Verbinde dich per SSH mit der Maschine und stelle sicher, dass du sudo verwenden kannst (oder melde dich als root an).
2. Führe den folgenden Befehl aus.
3. Der Installer fragt interaktiv nach deiner Servitium-E-Mail-Adresse und deinem Passwort. Es ist dasselbe Konto wie im Center.

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

Auf einer frischen Maschine dauert das etwa 2 bis 4 Minuten.

Was der Installer macht

Unter Windows führt der Installer Folgendes aus:

• Er lädt den Agent in einen eigenen Ordner herunter.
• Er installiert die Visual C++-Laufzeit und die DirectX-Laufzeitkomponenten, die Conan Exiles benötigt, falls sie fehlen.
• Er fügt für den Agent-Ordner eine Ausnahme in Windows Defender hinzu.
• Er registriert die Maschine in deinem Konto.
• Er installiert den Windows-Dienst Servitium Monitor. Dieser startet mit Windows und startet sich selbst neu, falls er stoppt.

Unter Linux führt der Installer Folgendes aus:

• Er installiert die Systempakete, die der Agent und SteamCMD benötigen (apt oder dnf).
• Er lädt den Agent herunter und registriert die Maschine in deinem Konto.
• Ist die Firewall ufw installiert, erlaubt er dem Agent, Spielports automatisch zu öffnen.
• Er legt den systemd-Dienst servitium-monitor an, der beim Systemstart aktiviert wird.

Du kannst den Installer bedenkenlos erneut ausführen: Er aktualisiert den Agent an Ort und Stelle und behält die Identität deines Hosts bei.

Prüfen, ob der Host erscheint

Öffne im Center Admin, Hosts. Deine Maschine sollte innerhalb von etwa 30 Sekunden erscheinen. Auf der Installationsseite hält Nach meinem Host suchen etwa zwei Minuten lang danach Ausschau und bestätigt, sobald die Verbindung steht.

Wenn sie nicht erscheint, prüfe den Dienst auf der Maschine:

Get-Service ServitiumMonitor

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

sudo systemctl status servitium-monitor

sudo journalctl -u servitium-monitor -f

Sobald der Host online ist, wähle auf der Hosts-Seite Gameserver hinzufügen, um deinen Server zuzuordnen. Weitere Lösungen findest du unter FAQ und Fehlerbehebung.

Agent aktualisieren

Um den Agent zu aktualisieren, führe denselben Installationsbefehl erneut aus. Er ersetzt das Programm, behält deine Einstellungen und die Host-Identität bei und startet den Dienst neu. Deine Gameserver und ihre Dateien bleiben unberührt.

Deinstallation

Unter Windows führst du das Deinstallationsprogramm in einer PowerShell mit Administratorrechten aus. Es entfernt den Dienst, stoppt die Gameserver, die es betrieben hat, löscht die Agent-Ordner und entfernt die von ihm angelegten Firewall-Regeln. Die Dateien deiner Gameserver bleiben erhalten, es sei denn, du fügst -WipeServers hinzu (und -WipeSteam, um auch SteamCMD zu entfernen).

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

Unter Linux stoppst und entfernst du den Dienst und das Agent-Programm:

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

Öffne zum Schluss im Center den Host unter Admin, Hosts und verwende Diesen Host löschen. Ihm zugeordnete Server werden nicht gelöscht, sondern verlieren nur ihre Zuordnung. Läuft der Agent noch irgendwo, registriert er sich bei der nächsten Verbindung erneut.