service

snippbot start runs the server in the foreground. To keep it running across reboots and restart it if it crashes, run it under your operating system’s process supervisor. snippbot service installs a user-level service that does this — without elevation. On Linux/macOS no root/sudo is required; on Windows it installs a per-user Startup-folder launcher that starts the daemon hidden at logon, so no Administrator rights are needed either.

It picks the right mechanism for your platform automatically:

OS	Mechanism	Location
Linux	systemd user unit	~/.config/systemd/user/snippbot.service
macOS	launchd LaunchAgent	~/Library/LaunchAgents/com.snippbot.daemon.plist
Windows	per-user Startup-folder launcher (hidden)	%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\Snippbot.vbs

Note

Process supervision is inherently OS-specific, so there is no single portable service file. The command is OS-agnostic and emits the correct artifact for the host. The published package can’t auto-install this (Python wheels don’t run post-install code) — run snippbot service install once after installing.

Usage

snippbot service install                 # install + start, defaults host 127.0.0.1 port 18781
snippbot service install --host 0.0.0.0 --port 18781   # expose on the network
snippbot service install --data-dir /srv/snippbot      # pin SNIPPBOT_DATA_DIR
snippbot service status                  # show whether it's running
snippbot service uninstall               # stop + remove

Notes

• Headless Linux: run loginctl enable-linger $USER so the user service runs without an active login session.
• Logs: systemd → journalctl --user -u snippbot; launchd → ~/.snippbot/logs/.
• The service runs snippbot start for you, so don’t also start the daemon manually.