systemd-Service für Gameserver: Autostart und Neustart
So richtest du einen systemd-Service für deinen Gameserver ein: Unit-Datei, Autostart beim Booten, Neustart nach Absturz, sauberes Stoppen und Fehlersuche.
So richtest du einen systemd-Service für deinen Gameserver ein: Unit-Datei, Autostart beim Booten, Neustart nach Absturz, sauberes Stoppen und Fehlersuche.
Mit einem systemd-Service läuft dein Gameserver unter Linux als richtiger Systemdienst. Er startet beim Booten von selbst, kommt nach einem Absturz automatisch zurück und schreibt seine Ausgabe ins Journal, wo du sie jederzeit nachlesen kannst. Dafür brauchst du eine einzige .service-Datei unter /etc/systemd/system/, einen eigenen Systembenutzer und ein paar gut gewählte Einstellungen. In dieser Anleitung bauen wir die Datei Zeile für Zeile auf, zeigen dir passende Varianten für Minecraft, FiveM und Spiele wie Satisfactory und erklären, wie du typische Startprobleme in wenigen Minuten findest.
/etc/systemd/system/gameserver.service und besteht aus den Abschnitten [Unit], [Service] und [Install].ExecStart braucht immer einen absoluten Pfad.Restart=on-failure mit RestartSec=10 holt einen abgestürzten Server zurück, StartLimitBurst verhindert endlose Neustart-Schleifen.KillSignal, TimeoutStopSec und bei Minecraft SuccessExitStatus=143 entscheidend.sudo systemctl daemon-reload. Fehler findest du mit systemctl status und journalctl -u.systemd ist auf fast allen aktuellen Linux-Distributionen das Init-System, also der erste Prozess, der beim Booten startet und alle weiteren Dienste verwaltet. Auch die LinuxGSM-Dokumentation zum Start beim Booten setzt systemd als Standard bei den meisten modernen Distributionen voraus. Du musst also nichts zusätzlich installieren, egal ob Debian, Ubuntu, AlmaLinux oder Rocky Linux.
Für einen Gameserver übernimmt systemd konkret diese Aufgaben:
Gegenüber einem Server, der in einer screen- oder tmux-Sitzung läuft, ist das deutlich robuster: Eine vergessene Sitzung, ein Reboot oder ein Absturz in der Nacht bedeuten nicht mehr, dass deine Community vor einem Offline-Server steht. Falls du noch zwischen den Betriebssystemen abwägst, hilft dir unser Vergleich Windows vs. Linux Server bei der Entscheidung. systemd ist eine reine Linux-Lösung.
Bevor du die Unit-Datei schreibst, braucht der Server ein sauberes Zuhause. Ein Spielprozess mit root-Rechten wäre bei einer Sicherheitslücke in einem Plugin oder Mod ein offenes Tor zum ganzen System. Lege deshalb einen eigenen Systembenutzer ohne Login-Shell an:
sudo useradd --system --create-home --shell /usr/sbin/nologin gameserver
sudo mkdir -p /opt/game
sudo chown -R gameserver:gameserver /opt/game
sudo chmod +x /opt/game/start.sh
In /opt/game liegen danach die Serverdateien und ein Startskript start.sh. Das Skript sollte den Serverprozess am Ende mit exec aufrufen, zum Beispiel exec /usr/bin/java -Xms4G -Xmx4G -jar server.jar nogui. So ersetzt der Spielprozess die Shell und bekommt die Signale von systemd direkt, statt dass nur das Skript beendet wird.
Prüfe vorher einmal manuell, ob der Server startet:
sudo -u gameserver /opt/game/start.sh
Läuft er hier nicht, läuft er auch als Dienst nicht. Diese Kontrolle spart dir später viel Sucherei im Journal.
Eigene Units gehören nach /etc/systemd/system/. Dieses Verzeichnis hat Vorrang vor den Unit-Dateien, die Pakete unter /usr/lib/systemd/system/ installieren. Lege die Datei mit sudo nano /etc/systemd/system/gameserver.service an:
[Unit]
Description=Gameserver
Wants=network-online.target
After=network-online.target
StartLimitIntervalSec=300
StartLimitBurst=5
[Service]
Type=simple
User=gameserver
Group=gameserver
WorkingDirectory=/opt/game
ExecStart=/opt/game/start.sh
Restart=on-failure
RestartSec=10
TimeoutStopSec=90
LimitNOFILE=65536
NoNewPrivileges=true
PrivateTmp=true
[Install]
WantedBy=multi-user.target
Die wichtigsten Zeilen im Überblick:
| Einstellung | Abschnitt | Wozu sie dient |
|---|---|---|
Description |
[Unit] | Name, der in systemctl status und im Journal erscheint |
Wants / After=network-online.target |
[Unit] | Startet den Server erst, wenn das Netzwerk wirklich steht |
StartLimitIntervalSec / StartLimitBurst |
[Unit] | Begrenzt, wie oft systemd in einem Zeitraum neu startet |
Type=simple |
[Service] | Der in ExecStart gestartete Prozess ist der Hauptprozess |
User / Group |
[Service] | Benutzer und Gruppe, unter denen der Server läuft |
WorkingDirectory |
[Service] | Arbeitsverzeichnis, relativ zu dem der Server Configs sucht |
ExecStart |
[Service] | Startbefehl, immer mit absolutem Pfad |
Restart / RestartSec |
[Service] | Neustart-Verhalten und Wartezeit davor |
TimeoutStopSec |
[Service] | Wie lange systemd beim Stoppen auf das Speichern wartet |
LimitNOFILE |
[Service] | Maximale Zahl offener Dateien und Sockets |
WantedBy=multi-user.target |
[Install] | Aktiviert den Dienst beim normalen Systemstart |
Zwei Punkte verdienen besondere Aufmerksamkeit:
Netzwerk vor dem Start. network.target bedeutet nur, dass die Netzwerkverwaltung läuft, nicht dass eine Verbindung besteht. Ein Server, der beim Start eine Masterliste oder Lizenzprüfung erreichen muss, wie FiveM mit dem Cfx-Backend, taucht sonst unter Umständen nicht in der Serverliste auf. Mit network-online.target bist du auf der sicheren Seite.
Arbeitsverzeichnis. Laut systemd.exec-Handbuchseite bei Debian ist ohne WorkingDirectory= bei einem Systemdienst das Wurzelverzeichnis / das Arbeitsverzeichnis. Viele Gameserver suchen server.properties, server.cfg oder Mod-Ordner relativ zum Arbeitsverzeichnis und starten sonst mit Standardwerten oder brechen ab.
Die Optionen NoNewPrivileges=true und PrivateTmp=true sind eine einfache Härtung: Der Prozess kann sich keine zusätzlichen Rechte verschaffen und bekommt ein eigenes /tmp. Weitere Schutzoptionen wie ProtectHome=true setzt du nur, wenn dein Server nicht unter /home liegt, sonst sperrst du ihn aus seinen eigenen Dateien aus.
Nach dem Anlegen oder jeder Änderung liest du die Konfiguration neu ein. Ohne diesen Schritt arbeitet systemd weiter mit der alten Fassung:
sudo systemctl daemon-reload
sudo systemctl enable --now gameserver
enable trägt den Dienst für den Autostart ein, --now startet ihn sofort. Die übrigen Befehle für den Alltag:
| Befehl | Wirkung |
|---|---|
sudo systemctl start gameserver |
Server starten |
sudo systemctl stop gameserver |
Server sauber stoppen |
sudo systemctl restart gameserver |
Stoppen und neu starten, etwa nach einem Mod-Update |
sudo systemctl disable gameserver |
Autostart beim Booten abschalten |
systemctl is-enabled gameserver |
Prüfen, ob der Autostart aktiv ist |
sudo systemctl edit gameserver |
Ergänzungen als Drop-in anlegen, ohne die Originaldatei zu ändern |
Drop-ins über systemctl edit sind praktisch, wenn du mehrere Server aus einer Vorlage betreibst oder nur einen Wert wie TimeoutStopSec anpassen willst. Die Änderungen landen in /etc/systemd/system/gameserver.service.d/override.conf.
Betreibst du mehrere Instanzen, etwa drei Minecraft-Server oder einen Test- und einen Live-Server, lohnt sich eine Template-Unit [email protected]. Darin ersetzt %i den Instanznamen, zum Beispiel WorkingDirectory=/opt/game/%i. Gestartet wird dann mit systemctl enable --now gameserver@survival.
Der Kern der Sache ist Restart=. Nach der offiziellen systemd.service-Dokumentation legt diese Option fest, ob ein Dienst neu gestartet wird, wenn sein Prozess endet, getötet wird oder in ein Timeout läuft. Stoppst du den Dienst selbst mit systemctl stop, startet systemd ihn bewusst nicht neu.
| Wert | Neustart, wenn … | Eignung für Gameserver |
|---|---|---|
no |
nie | nur für manuelle Tests |
on-failure |
Exit-Code ungleich 0, Absturz durch Signal, Timeout oder Watchdog | die übliche Wahl |
on-abnormal |
Absturz durch Signal, Timeout oder Watchdog, nicht bei Fehlercode | selten sinnvoll |
on-abort |
nur bei unbehandeltem Signal | selten sinnvoll |
always |
in jedem Fall, auch nach sauberem Beenden | wenn der Server sich per Ingame-Befehl neu starten soll |
Restart=on-failure ist für die meisten Server richtig: Ein Absturz wird abgefangen, ein bewusstes /stop in der Konsole aber respektiert. Restart=always passt, wenn du Neustarts im Spiel auslöst, etwa über einen Admin-Befehl oder ein Plugin, und der Server danach sofort wieder hochfahren soll.
Ein Server, der wegen einer kaputten Config sofort wieder abstürzt, würde ohne Grenze endlos neu starten. systemd hat dafür eine eingebaute Bremse: Wird eine Unit innerhalb von StartLimitIntervalSec öfter als StartLimitBurst-mal gestartet, verweigert systemd weitere Starts, wie die systemd.unit-Dokumentation beschreibt. Die Standardwerte liegen laut Michael Stapelberg seit systemd 255 bei 5 Starts in 10 Sekunden, bei einer Wartezeit von nur 100 ms.
Das Problem dabei: Mit dem Standard-RestartSec von 100 ms ist das Limit in einer Sekunde erreicht, mit RestartSec=10 dagegen nie, weil fünf Starts nicht in zehn Sekunden passen. Unsere Beispielwerte, RestartSec=10 mit StartLimitIntervalSec=300 und StartLimitBurst=5, bedeuten: Nach fünf Abstürzen innerhalb von fünf Minuten gibt systemd auf und markiert den Dienst als failed. So fällt dir ein echter Fehler auf, statt dass er im Hintergrund weiterrotiert. Hast du die Ursache behoben, setzt sudo systemctl reset-failed gameserver den Zähler zurück.
Wichtig: Die beiden StartLimit-Optionen gehören in den [Unit]-Abschnitt, nicht in [Service]. Ältere Anleitungen zeigen sie noch im falschen Abschnitt.
Ein Neustart nützt wenig, wenn beim Stoppen die letzte halbe Stunde Spielfortschritt verloren geht. Hier unterscheiden sich Spiele stark.
Minecraft (Java): systemd sendet beim Stoppen standardmäßig SIGTERM. Der Server speichert daraufhin die Welt und beendet sich mit dem Exit-Code 143 (128 + 15 für SIGTERM). Ohne Anpassung wertet systemd das als Fehler. Mit SuccessExitStatus=143 gilt dieser Code als sauberes Ende, wie auch das Beispiel bei evpo.net zeigt. Große Welten brauchen Zeit zum Speichern, daher TimeoutStopSec=90 oder mehr.
Satisfactory: Das offizielle Satisfactory-Wiki empfiehlt KillSignal=SIGINT, weil der Server auf SIGTERM ohne sauberes Beenden reagiert. Da der Dedicated Server beim Herunterfahren nicht automatisch speichert, solltest du zusätzlich das automatische Speichern beim Verlassen von Spielern aktivieren. Wie du den Server grundsätzlich aufsetzt, steht in unserer Satisfactory-Anleitung.
FiveM: Das Startskript run.sh ist nur ein Wrapper, der eigentliche Server läuft als Kindprozess. Mit KillMode=mixed bekommt der Hauptprozess das Stopp-Signal, alle übrigen Prozesse werden danach ebenfalls beendet. Sonst bleibt der Spielport belegt und der nächste Start scheitert.
Eine kompakte Übersicht:
| Spiel | Wichtige Zusätze in [Service] |
|---|---|
| Minecraft Java | SuccessExitStatus=143, TimeoutStopSec=90 |
| FiveM | KillMode=mixed, ExecStart=/opt/fivem/run.sh +exec server.cfg |
| Satisfactory | KillSignal=SIGINT, längeres TimeoutSec |
| Garry’s Mod / Source-Spiele | TimeoutStopSec an Map- und Addon-Größe anpassen |
Da ein systemd-Dienst keine interaktive Konsole hat, schickst du Befehle wie save-all oder say am besten per RCON. Welche Einstellungen du dabei absichern solltest, erklären wir in RCON Sicherheit für Gameserver.
Der erste Blick geht immer auf den Status:
sudo systemctl status gameserver
Du siehst, ob der Dienst läuft, seit wann, mit welcher PID und mit welchem Exit-Code er zuletzt beendet wurde. Darunter stehen die letzten Log-Zeilen. Für mehr Details nutzt du das Journal:
sudo journalctl -u gameserver -f # live mitlesen
sudo journalctl -u gameserver --since today # alles von heute
sudo journalctl -u gameserver -e # ans Ende springen
systemctl list-units --type=service --state=failed
Die häufigsten Fehler und ihre Lösung:
| Symptom im Status oder Journal | Ursache | Lösung |
|---|---|---|
status=203/EXEC |
Pfad in ExecStart falsch oder Skript nicht ausführbar |
absoluten Pfad prüfen, chmod +x setzen |
status=217/USER |
Benutzer aus User= existiert nicht |
Benutzer anlegen oder Namen korrigieren |
Permission denied |
Dateien gehören root | chown -R gameserver:gameserver /opt/game |
start-limit-hit |
zu viele Abstürze in kurzer Zeit | Ursache im Journal suchen, dann reset-failed |
| Neustart-Schleife beim Laden | Start dauert länger als das Timeout | TimeoutStartSec oder TimeoutSec erhöhen |
Address already in use |
alter Prozess hält den Port | KillMode=mixed setzen, Restprozesse beenden |
| Server startet mit Standard-Config | WorkingDirectory fehlt |
Arbeitsverzeichnis setzen |
| Änderung wirkt nicht | daemon-reload vergessen |
sudo systemctl daemon-reload |
Das Timeout-Problem trifft vor allem große Spiele: Auf den meisten Distributionen brechen Dienste nach 90 Sekunden ab, wenn sie nicht als gestartet gelten. Ein Server, der zum Laden einer großen Welt länger braucht, landet so in einer Schleife aus Abbruch und Neustart.
Für eine vorausschauende Überwachung eignet sich OnFailure=: Damit startet systemd bei einem endgültigen Fehler eine zweite Unit, die dir zum Beispiel eine Nachricht an Discord schickt. Ein Beispiel für diesen Ansatz findest du im Red-Hat-Beitrag zu selbstheilenden Diensten.
Kommt dein Server nach einem Kernel-Update oder einer fehlerhaften Konfiguration gar nicht mehr hoch, hilft das Rescue-System. Wie das auf Root Servern bei uns funktioniert, steht in der Anleitung Dedicated Server installieren und Rescue-System.
Wir sehen in unserem Support immer wieder dasselbe Muster: Ein Server läuft wochenlang in einer screen-Sitzung, bis ein Neustart des Hosts ansteht und danach niemand mehr weiß, wie er gestartet wurde. Ein systemd-Service schreibt dieses Wissen fest in eine Datei. Das ist für uns die wichtigste Grundlage, wenn du einen Gameserver auf einem eigenen VPS oder Root Server betreibst.
Unsere Empfehlung: Fang mit der schlanken Unit aus dieser Anleitung an, ergänze dann gezielt die spielspezifischen Optionen und teste einen Absturz bewusst mit
kill -9auf die PID. Erst wenn der Server danach von selbst zurückkommt und ein normalessystemctl stopdie Welt sauber speichert, ist die Einrichtung fertig.Genauso wichtig wie die Unit ist die Umgebung darunter. Ein Neustart in zehn Sekunden hilft nur, wenn der Server auch schnell wieder lädt und erreichbar bleibt. Deshalb setzen wir auf NVMe-SSDs, inkludierten DDoS-Schutz ohne Mehrkosten und Rechenzentren in Deutschland, und unser Team hilft dir direkt, wenn es doch einmal hakt.
Erik
Für einen systemd-Service brauchst du vollen Root-Zugriff auf ein Linux-System. Bei Nexthosting bekommst du den mit einem VPS für Gameserver: Die VPS-Tarife beginnen bei 6,49 € im Monat (VPS Einfach), für größere Communities gibt es VPS Standard für 10,90 €, VPS Pro für 19,90 € und VPS Ultra für 30,90 € im Monat. Wer mehrere Instanzen oder ein großes RP-Projekt betreibt, findet Dedicated Server für Gameserver, für FiveM-Projekte auch als Dedicated Server für FiveM. Möchtest du dich gar nicht um systemd kümmern, sind unsere fertigen Gameserver die Alternative, etwa Minecraft ab 7,99 € im Monat.
Nein. systemd ist auf Debian, Ubuntu, AlmaLinux, Rocky Linux und den meisten anderen aktuellen Distributionen bereits das Init-System. Mit systemctl --version prüfst du, welche Version auf deinem Server läuft.
on-failure startet nur nach einem Fehler neu, also bei einem Exit-Code ungleich 0, einem Absturz durch ein Signal oder einem Timeout. always startet auch nach einem sauberen Beenden neu, zum Beispiel nach einem /stop im Spiel. Ein systemctl stop respektieren beide Varianten.
Dann hat das Start-Limit gegriffen und der Dienst steht auf failed mit dem Hinweis start-limit-hit. Suche mit journalctl -u gameserver -e die Ursache, behebe sie und setze den Zähler mit sudo systemctl reset-failed gameserver zurück. Danach startest du den Dienst wieder normal.
Ein Dienst hat keine interaktive Konsole, deshalb nutzt du RCON oder die eingebaute Remote-Konsole des Spiels. Setze dafür ein starkes Passwort und gib den RCON-Port nicht unnötig nach außen frei.
Ja, mit einer Template-Unit wie [email protected]. Der Platzhalter %i steht für den Instanznamen, sodass jede Instanz ihr eigenes Verzeichnis und eigene Logs bekommt. Du startest sie mit systemctl enable --now gameserver@name.
Für eigene Anwendungen, Docker, Datenbanken und individuelle Setups.
VPS ansehenUnser Support hilft dir bei technischen Fragen und der Auswahl eines passenden Produkts.
Support öffnen