Files
spothole/docs/systemd.md
T
2026-08-08 08:42:29 +01:00

34 lines
970 B
Markdown

## systemd configuration
If you want Spothole to run automatically on startup on a Linux distribution that uses `systemd`, follow the
instructions here. For distros that don't use `systemd`, or Windows/OSX/etc., you can find generic instructions for your
OS online.
Create a file at `/etc/systemd/system/spothole.service`. Give it the following content, adjusting for the user you want
to run it as and the directory in which you have installed it:
```
[Unit]
Description=Spothole
After=syslog.target network.target
[Service]
Type=simple
User=spothole
WorkingDirectory=/home/spothole/spothole
ExecStart=/home/spothole/spothole/.venv/bin/python /home/spothole/spothole/spothole.py --serve-in-foreground
Restart=on-abort
[Install]
WantedBy=multi-user.target
```
Run the following:
```bash
sudo systemctl daemon-reload
sudo systemctl enable spothole
sudo systemctl start spothole
```
Check the service has started up correctly with `sudo journalctl -u spothole -f`.