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 inExecStartstimmt 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.
Für die Community
Du kennst dich aus? Schreib eine Anleitung.
Teile, was du weißt: Wir prüfen jede eingereichte Anleitung, veröffentlichen sie mit deinem Namen und bedanken uns mit Guthaben für deine Dienste.