Document systemd user service setup

This commit is contained in:
Federico Jaramillo Martinez
2026-05-07 13:49:02 +02:00
parent bc21d1a6f8
commit 7f053b0fc6
2 changed files with 68 additions and 0 deletions
+10
View File
@@ -0,0 +1,10 @@
# Agent Notes
This project is expected to run locally using split systemd user services:
- `pi-web-sessiond.service` runs `npm run start:sessiond` in non-autoreload, non-auto-restart mode.
- `pi-web-ui-dev.service` runs the web/API and Vite UI in dev autoreload mode with `npm run dev:web` and `npm run dev:client`.
When working on this project, assume the session runtime owner is long-lived and separate from the autoreloading UI/API process. Browser disconnects and UI/API restarts should not stop active Pi sessions.
If you make changes that affect `src/server/sessiond.ts`, session runtime ownership, the session daemon protocol, or any code path only loaded by the session daemon, inform the user that `pi-web-sessiond.service` must be manually restarted. Changes to the web/API/UI side generally only require the `pi-web-ui-dev.service` autoreload/restart path.