Skip to content

Commit 67a2b56

Browse files
Alpaca233claude
andcommitted
docs(watchdog): flesh out the systemd install steps in the README
Full copy/enable sequence (mkdir, cp, WorkingDirectory fix via $PWD, daemon-reload, enable --now, status), plus logs (journalctl), enable-linger, and the interpreter note. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 606f67c commit 67a2b56

1 file changed

Lines changed: 12 additions & 4 deletions

File tree

software/acquisition_watchdog/README.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -52,13 +52,21 @@ Slack alert. A clean finish produces nothing.
5252
A manual run stops when you close the terminal or reboot. To keep it up independently of the
5353
GUI:
5454

55-
- **Linux (systemd user service):** copy `systemd/squid-acquisition-watchdog.service` to
56-
`~/.config/systemd/user/`, edit `WorkingDirectory` to your `software/` path, then:
55+
- **Linux (systemd user service)** — run these from the `software/` directory:
5756
```bash
57+
mkdir -p ~/.config/systemd/user
58+
cp acquisition_watchdog/systemd/squid-acquisition-watchdog.service ~/.config/systemd/user/
59+
# The shipped unit's WorkingDirectory is a placeholder (%h/Squid/software); point it here:
60+
sed -i "s#^WorkingDirectory=.*#WorkingDirectory=$PWD#" ~/.config/systemd/user/squid-acquisition-watchdog.service
5861
systemctl --user daemon-reload
59-
systemctl --user enable --now squid-acquisition-watchdog
62+
systemctl --user enable --now squid-acquisition-watchdog # auto-start at login + start now
63+
systemctl --user status squid-acquisition-watchdog # verify it's active
6064
```
61-
It starts at login, restarts on failure, and keeps running across GUI restarts.
65+
Enable it once and it comes up at every login and restarts on failure (`Restart=always`) —
66+
no need to launch it by hand. Logs: `journalctl --user -u squid-acquisition-watchdog -f`.
67+
To keep it running before/without a graphical login, also run `loginctl enable-linger $USER`
68+
once. (The unit runs `/usr/bin/python3`; if Squid runs on a different interpreter/venv, edit
69+
the `ExecStart=` line to that python.)
6270
- **Windows (Task Scheduler):** run `windows/install.ps1` in PowerShell from `software\`. It
6371
registers a logon-triggered task (via `pythonw.exe`; make sure it's on `PATH`, or edit the
6472
path in the script).

0 commit comments

Comments
 (0)