wrolpi/etc/raspberrypios/wrolpi-api-dev.service
Roland 9e3ac4de5c
systemd: KillMode=mixed for the API so main shuts its own children down
With control-group kill, SIGTERM reaches the multiprocessing Manager at
the same moment as Sanic's main process; main's cleanup then writes
worker state to a dead Manager (broken pipe) and exits 1, so a plain
`systemctl stop` is recorded as a failure whenever a child takes a
moment to stop (a transcode being killed, for instance).  Signal only
main; it stops the workers and the perpetual process itself.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-24 19:07:04 -06:00

26 lines
1,002 B
Desktop File

[Unit]
Description=WROLPi Python API (Development)
PartOf=wrolpi.target
Conflicts=wrolpi-api.service
[Service]
Environment=PYTHONUNBUFFERED=1
# Sanic 25.x wants 'spawn' but our code uses 'fork' for multiprocessing.
Environment=SANIC_START_METHOD_SET=1
# Required for yt-dlp to access GNOME keyring for browser cookie decryption.
Environment=DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/%U/bus
ExecStart=/opt/wrolpi/venv/bin/python -m sanic main:api_app --host 0.0.0.0 --port 8081 -w 2 --reload --debug
ExecReload=/bin/kill -HUP $MAINPID
Group=wrolpi
User=wrolpi
WorkingDirectory=/opt/wrolpi/
Restart=on-failure
# Signal only Sanic's main process on stop; it shuts its workers, the perpetual process and the multiprocessing
# Manager down itself. Signalling the whole cgroup at once kills the Manager under main's own cleanup (broken
# pipe, exit 1). Stragglers still get SIGKILL at TimeoutStopSec.
KillMode=mixed
# Higher than the App so the API can start.
Nice=4
[Install]
WantedBy=default.target