pitchfork boot
- Usage:
pitchfork boot <SUBCOMMAND> - Effect: read-only
Enable or disable boot start
Manages whether pitchfork supervisor starts automatically when the system boots. Uses platform-specific mechanisms (launchd on macOS, systemd on Linux).
When run as root (or via sudo), registers a system-level entry that starts pitchfork for all users:
macOS: /Library/LaunchDaemons/pitchfork.plist
Linux: /etc/systemd/system/pitchfork.service
When run as a normal user, registers a user-level entry:
macOS: ~/Library/LaunchAgents/pitchfork.plist
Linux: ~/.config/systemd/user/pitchfork.service
A system-level entry registered through sudo records the invoking user (supervisor run --boot --invoking-user <user>). At boot, the root supervisor behaves as if that user had started it with sudo: it reads their ~/.config/pitchfork/config.toml, keeps state files and IPC sockets in their home directory, and runs daemons as that user unless settings.supervisor.user or a daemon's user says otherwise. A system-level entry registered from a root login shell records no user and runs entirely as root.
Running enable again rewrites an existing entry, for example to record the invoking user in an entry created by an older version.
Subcommands:
enable Register pitchfork to start on boot
disable Remove pitchfork from boot startup
status Check if boot start is currently enabled
Examples:
pitchfork boot enable Start pitchfork on system boot (user-level)
sudo pitchfork boot enable Start pitchfork on system boot (system-level)
pitchfork boot disable Don't start pitchfork on boot
pitchfork boot status Check boot start status
Flags
-h --help— Print help