Autostart

setup.sh richtet Autostart automatisch ein. Diese Seite erklärt die launchctl-Befehle, die du auf macOS im Alltag brauchst, und zeigt was auf Linux anders ist.

macOS LaunchAgent

setup.sh installiert eine LaunchAgent-Plist unter ~/Library/LaunchAgents/com.penates.plist. launchd lädt sie beim Login und hält den Server am Laufen. Die Plist wird von setup.sh idempotent neu erzeugt. Erneutes Ausführen nach einem Update ist sicher.

Hinweis

Die Plist muss Mode 644 haben. launchd verweigert world-writable Plists stillschweigend (Bootstrap failed: 5). setup.sh setzt das; wenn du die Plist manuell bearbeitest, danach chmod 644 ~/Library/LaunchAgents/com.penates.plist ausführen.

Status

launchctl list | grep penates

Eine Zeile mit PID in der zweiten Spalte bedeutet, der Server läuft. 0 = sauber beendet. Negativer Wert = Exit-Code: logs/stderr.log prüfen.

Neu starten

Nach Änderungen an .env oder nach Code-Updates:

launchctl kickstart -k gui/$(id -u)/com.penates

Stoppen

launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.penates.plist

Der LaunchAgent wird entladen und der Server stoppt. Wieder manuell starten:

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.penates.plist

Logs

tail -f ~/penates/logs/stdout.log
tail -f ~/penates/logs/stderr.log

Audit-Log

Sicherheits-Events (Auth-Versuche, Session-Lifecycle, Rate-Limit-Treffer) werden im JSONL-Format nach ~/.penates/audit.log geschrieben:

tail -f ~/.penates/audit.log | jq -c

Linux (systemd)

Auf Linux installiert setup.sh eine systemd-User-Unit unter ~/.config/systemd/user/penates.service und aktiviert sie mit loginctl enable-linger, damit der Service auch ohne aktive Session läuft. Entsprechende Befehle:

systemctl --user status penates
systemctl --user restart penates
systemctl --user stop penates
journalctl --user -u penates -f

Mehr Details: Plattform-Hinweise.