Den ostserver-Dienst verwalten

ostserver läuft im Hintergrund als systemd-Dienst. Systemd ist der Dienstmanager von Linux: Es startet ostserver automatisch beim Hochfahren der Maschine, startet ihn bei einem Absturz neu und erlaubt die Steuerung über einfache Befehle.


Starten, stoppen, neu starten

# Dienst starten
sudo systemctl start ostserver

# Dienst stoppen
sudo systemctl stop ostserver

# Dienst neu starten (nützlich nach Änderung der Optionen)
sudo systemctl restart ostserver

# Status des Dienstes anzeigen
sudo systemctl status ostserver

Automatischen Start aktivieren / deaktivieren

Standardmäßig ist der Dienst aktiviert: Er startet automatisch bei jedem Hochfahren der Maschine.

# Automatischen Start deaktivieren
sudo systemctl disable ostserver

# Automatischen Start wieder aktivieren
sudo systemctl enable ostserver

Logs einsehen

# Die letzten Logs anzeigen
sudo journalctl -u ostserver

# Logs in Echtzeit verfolgen
sudo journalctl -u ostserver -f

# Auf die letzten 100 Zeilen begrenzen
sudo journalctl -u ostserver -n 100

Startoptionen anpassen

Bei der Installation wird eine Konfigurationsdatei im Home-Verzeichnis des Benutzers erstellt:

~/.ost/ostserver.parms

Diese Datei enthält ein Argument pro Zeile. Zeilen, die mit # beginnen, sind Kommentare und werden ignoriert. Leerzeichen in Werten werden nativ unterstützt — Anführungszeichen sind nicht nötig.

Zum Bearbeiten:

nano ~/.ost/ostserver.parms

Beispielinhalt:

# Web server media folder (must be writable)
--webroot=/var/lib/osterix/media

# Start embedded INDI server (Y/N)
--indiserver=Y

# Log level: 0=debug, 1=info, 2=warning, 3=error, 4=critical
--loglevel=1

# Security level: 0=disabled, 1=read only, 2=user grants
--grant=0

# Frontend banner text (spaces are allowed, no quoting needed)
--banner=Mein Observatorium ohne Kopf

Nach jeder Änderung den Dienst neu starten, damit sie wirksam wird:

sudo systemctl restart ostserver
Datei bleibt bei Updates erhalten

Die Datei ostserver.parms wird bei einem Paket-Update niemals überschrieben. Ihre Anpassungen bleiben erhalten.


Referenz der verfügbaren Optionen

OptionStandardBeschreibung
--webroot=<Pfad>/var/lib/osterix/mediaVon nginx ausgeliefertes Medienverzeichnis
--indiserver=Y|NNEingebetteten INDI-Server starten
--loglevel=<0-4>1Log-Verbosität: 0=debug, 1=info, 2=warning, 3=error, 4=critical
--logfile=<Pfad>(zeitgestempelt in ~/.ost/)Pfad der Log-Datei
--grant=<0|1|2>Sicherheit: 0=deaktiviert, 1=nur Lesen, 2=Benutzer-Grants
--lng=<fr|en|...>frSprache der Oberfläche (fr, en, de, it, es)
--banner=<Text>Observatoire Sans têteIm Frontend angezeigtes Banner
--configuration=<Name>defaultBeim Start zu ladende Konfiguration
--libpath=<Pfad>(Systempfad)Verzeichnis der .so-Module
--dbpath=<Pfad>(Arbeitsverzeichnis)Speicherort der Datenbank
--systemwatchinterval=<s>10Intervall der Systemüberwachung in Sekunden (0 zum Deaktivieren)
--minfree=<0-99>10Minimal freier Speicherplatz in % vor Überspringen des Bild-Schreibens
--ssl=Y|NNSSL für das WebSocket aktivieren
--sslcert=<Pfad>/etc/ost/server.crtSSL-Zertifikat
--sslkey=<Pfad>/etc/ost/server.keySSL-Privatschlüssel
--setadminpassword=<Passwort>Administrator-Passwort festlegen (nach Gebrauch entfernen)