Launch on boot
Last updated on May 21, 2026
When Launch on boot is on, the CLI starts as a background service the moment the station boots. The bench is ready to pull deployments and accept runs without anyone opening a terminal.
Toggle the setting
Open Stations → Station name → Setup and flip Launch on boot. The dashboard pushes the new value to the bench over the live channel, and the CLI applies it on receipt.
How it works
The CLI registers itself with the platform's service manager when the toggle flips on:
- Linux: a
systemduser unit that runs the CLI under the logged-in user. - macOS: a
launchdLaunchAgentplist. - Windows: a Run-key entry under
HKCU\Software\Microsoft\Windows\CurrentVersion\Run.
The same machinery is exposed manually through tofupilot install. The dashboard toggle is the recommended way for fleet management; the CLI command is the local fallback for benches without dashboard write access.
Turning it off
When you flip the toggle off, the CLI deregisters the service entry and removes the boot hook. The CLI keeps running for the current session; the next reboot starts it only when the operator launches it manually.
How is this guide?
Kiosk UI
Learn how to boot a TofuPilot station into a full-screen browser with no tabs or chrome so operators see only the procedure they need to run.
Desktop shortcut
Place a TofuPilot shortcut on the station desktop so operators can launch a test run with a single click, with no terminal commands or browser bookmarks.