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 systemd user unit that runs the CLI under the logged-in user.
  • macOS: a launchd LaunchAgent plist.
  • 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?

On this page