Linux & Software2 Min. Lesezeit

Eigene Anwendung als systemd-Dienst betreiben (Node.js, Python, Go)

Ein Programm mit systemd dauerhaft im Hintergrund laufen lassen: Unit-Datei schreiben, automatisch starten und neu starten, Umgebungsvariablen, eigener Benutzer und Protokolle mit journalctl.

Du hast eine Node.js-App, einen Python-Bot oder ein Go-Programm geschrieben und willst, dass es dauerhaft läuft, nach einem Absturz neu startet und nach einem Server-Neustart von selbst wieder hochkommt. Dafür brauchst du kein screen, kein nohup und kein zusätzliches Werkzeug: systemd ist auf jedem modernen Linux schon da.

Eigener Benutzer für die App

Lass Anwendungen nie als root laufen. Lege einen Systembenutzer ohne Anmeldung an:

sudo useradd --system --create-home --home-dir /opt/meineapp --shell /usr/sbin/nologin meineapp

Kopiere deine Anwendung nach /opt/meineapp und gib sie dem Benutzer:

sudo chown -R meineapp:meineapp /opt/meineapp

Die Unit-Datei

sudo nano /etc/systemd/system/meineapp.service
[Unit]
Description=Meine App
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=meineapp
Group=meineapp
WorkingDirectory=/opt/meineapp
ExecStart=/usr/bin/node /opt/meineapp/server.js
Restart=on-failure
RestartSec=5
EnvironmentFile=/opt/meineapp/.env

# etwas Schutz für das System
NoNewPrivileges=true
ProtectSystem=full
PrivateTmp=true

[Install]
WantedBy=multi-user.target

ExecStart braucht den vollen Pfad zum Programm. Den findest du mit which node bzw. which python3. Für ein Python-Programm in einer virtuellen Umgebung lautet die Zeile zum Beispiel ExecStart=/opt/meineapp/venv/bin/python /opt/meineapp/bot.py.

Umgebungsvariablen

Geheimnisse wie Tokens und Passwörter gehören nicht in die Unit-Datei, sondern in die EnvironmentFile:

sudo nano /opt/meineapp/.env
PORT=3000
DATABASE_URL=mysql://meineapp:passwort@localhost/meineapp
sudo chown meineapp:meineapp /opt/meineapp/.env
sudo chmod 600 /opt/meineapp/.env

Starten

sudo systemctl daemon-reload
sudo systemctl enable --now meineapp
systemctl status meineapp

enable startet den Dienst bei jedem Hochfahren, --now zusätzlich sofort.

Die wichtigsten Befehle

Befehl Wirkung
sudo systemctl restart meineapp neu starten, etwa nach einem Update
sudo systemctl stop meineapp anhalten
sudo systemctl disable meineapp nicht mehr beim Hochfahren starten
journalctl -u meineapp -f Ausgabe live mitlesen
journalctl -u meineapp --since "1 hour ago" Ausgabe der letzten Stunde
sudo systemctl daemon-reload nach jeder Änderung der Unit-Datei

Alles, was dein Programm auf die Konsole schreibt, landet automatisch im Journal. Eigene Log-Dateien brauchst du nicht.

Wenn der Dienst nicht startet

systemctl status meineapp
journalctl -u meineapp -n 50 --no-pager

Häufige Ursachen:

  • status=203/EXEC: Der Pfad in ExecStart stimmt nicht oder die Datei ist nicht ausführbar.
  • status=217/USER: Den Benutzer gibt es nicht.
  • Permission denied: Der Benutzer darf Dateien im Arbeitsverzeichnis nicht lesen oder schreiben.
  • Startet und stirbt sofort: Fehler im Programm selbst, das Journal zeigt die Meldung.

Startet zu oft neu?

Stürzt ein Programm dauernd ab, gibt systemd nach fünf Versuchen in zehn Sekunden auf. Das ist gewollt. Behebe den Fehler und setze den Zähler zurück:

sudo systemctl reset-failed meineapp
sudo systemctl start meineapp

Von außen erreichbar machen

Lauscht deine App auf 127.0.0.1:3000, machst du sie mit Nginx als Reverse Proxy oder Caddy unter deiner Domain mit HTTPS erreichbar.

Geschrieben von TryNxt-Team

Wir bauen und betreiben TryNxt selbst und schreiben hier auf, was wir dabei lernen.