Datenschutz-Hinweis Diese Website verwendet nur technisch notwendige Cookies. Statistik-, Marketing- und externe Dienste werden ohne JavaScript nicht geladen. Mehr dazu in unserer Datenschutzerklärung.
Privacy notice This website uses only technically necessary cookies. Statistics, marketing and external services are not loaded without JavaScript. Read more in our Privacy Policy.
Informacja o prywatności Ta strona używa wyłącznie technicznie niezbędnych plików cookie. Statystyka, marketing i usługi zewnętrzne nie są ładowane bez JavaScript. Więcej w naszej Polityce prywatności.
Information sur la confidentialité Ce site n’utilise que des cookies techniquement nécessaires. Les services de statistiques, de marketing et les services externes ne sont pas chargés sans JavaScript. Plus d’informations dans notre Politique de confidentialité.
Avviso sulla privacy Questo sito usa solo cookie tecnicamente necessari. I servizi statistici, di marketing ed esterni non vengono caricati senza JavaScript. Maggiori informazioni nella nostra Informativa sulla privacy.
Aviso de privacidad Este sitio web solo usa cookies técnicamente necesarias. Los servicios de estadística, marketing y externos no se cargan sin JavaScript. Más información en nuestra Política de privacidad.
Privacymelding Deze website gebruikt alleen technisch noodzakelijke cookies. Statistiek-, marketing- en externe diensten worden zonder JavaScript niet geladen. Meer hierover in onze Privacyverklaring.
Privatlivsinformation Denne hjemmeside bruger kun teknisk nødvendige cookies. Statistik-, marketing- og eksterne tjenester indlæses ikke uden JavaScript. Læs mere i vores Privatlivspolitik.
Gameserver Hosting

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.

12 Min. Lesezeit

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.

Nexthosting
nexthosting.net
Gameserver zuverlässig betreiben
Nexthosting bietet Gameserver, VPS und Dedicated Server mit DDoS-Schutz, schneller Bereitstellung und persönlichem Support.
Hosting-Angebote ansehen

Kurz gesagt

  • Die Unit-Datei liegt unter /etc/systemd/system/gameserver.service und besteht aus den Abschnitten [Unit], [Service] und [Install].
  • Der Server läuft unter einem eigenen Benutzer ohne Login-Shell, nie als root. ExecStart braucht immer einen absoluten Pfad.
  • Restart=on-failure mit RestartSec=10 holt einen abgestürzten Server zurück, StartLimitBurst verhindert endlose Neustart-Schleifen.
  • Für ein sauberes Herunterfahren mit gespeicherter Welt sind KillSignal, TimeoutStopSec und bei Minecraft SuccessExitStatus=143 entscheidend.
  • Nach jeder Änderung: sudo systemctl daemon-reload. Fehler findest du mit systemctl status und journalctl -u.

Inhaltsverzeichnis

Was ein systemd-Dienst für deinen Gameserver übernimmt

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:

  • Autostart: Nach einem Reboot, etwa nach einem Kernel-Update, ist der Server ohne dein Zutun wieder online.
  • Überwachung: Stürzt der Prozess ab, startet systemd ihn nach einer festgelegten Pause neu.
  • Logging: Alles, was der Server auf die Konsole schreibt, landet im systemd-Journal, mit Zeitstempel und durchsuchbar.
  • Rechte und Isolation: Du legst fest, unter welchem Benutzer der Prozess läuft und auf welche Teile des Systems er zugreifen darf.
  • Ressourcen: Limits wie die maximale Zahl offener Dateien setzt du direkt in der Unit.

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.

Vorbereitung: Benutzer, Verzeichnis und Startskript

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.

Die Service-Datei Schritt für Schritt

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.

Dienst aktivieren, starten und stoppen

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.

Automatischer Neustart nach einem Absturz

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.

Neustart-Schleifen vermeiden

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.

Sauber herunterfahren und Spielstände schützen

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.

Status, Logs und typische Startprobleme

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.

Unsere Sicht aus dem Hosting-Alltag

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 -9 auf die PID. Erst wenn der Server danach von selbst zurückkommt und ein normales systemctl stop die 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

Der passende Server für deinen eigenen Dienst

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.

Häufige Fragen

Muss ich systemd auf meinem Server installieren?

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.

Was ist der Unterschied zwischen Restart=on-failure und Restart=always?

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.

Warum startet mein Gameserver nach mehreren Abstürzen nicht mehr?

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.

Wie schicke ich Befehle an einen Server, der als systemd-Dienst läuft?

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.

Kann ich mehrere Gameserver mit einer Unit-Datei betreiben?

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.

Quellen

Mehr Kontrolle benötigt?

Für eigene Anwendungen, Docker, Datenbanken und individuelle Setups.

VPS ansehen

Frage zu deinem Projekt?

Unser Support hilft dir bei technischen Fragen und der Auswahl eines passenden Produkts.

Support öffnen