tofupilot service

Last updated on November 20, 2026

The service command manages the running station daemon (systemd on Linux, launchd on macOS), which tofupilot login --token puts under supervision when you set up a station.

start

The start subcommand runs the daemon in the foreground, and systemd and launchd use it as the ExecStart target. You rarely call it by hand.

service start
tofupilot service start

stop

The stop subcommand stops the running daemon.

service stop
tofupilot service stop

status

The status subcommand probes the loopback port the operator UI binds, then shows the supervisor's view, the resolved port, any TOFUPILOT_LOCAL_UI_PORT override, and log locations.

service status
tofupilot service status

The exit code follows one contract: 0 if and only if the operator UI socket is accepting on the resolved port, so scripts can rely on exit==0 meaning the daemon is live. With --json, a dead socket always exits 1; in human mode the CLI propagates the supervisor's non-zero exit code when available (systemd uses 3 for inactive and 4 for not installed), clamped to 1 when the supervisor claims success despite the dead socket.

Environment variables

Once the station has declared or fetched environment variables, status adds a line on its cache, and one line per procedure that is not configured:

service status
Environment variables: fetched 2026-10-20 08:14:03 UTC; cache key in file
Board Functional Test: not configured: secrets.MES_TOKEN missing

The cache key is kept in credential-manager (Windows), keychain (macOS) or file (Linux, or when the OS store is unavailable: a 0600 file next to the station credentials). When the last fetch failed, the line is a warning ending in stale: and the error: runs then use the cached values.

With --json, the same data is under values:

service status --json
{
  "values": {
    "cache_protection": "file",
    "etag": "9f2c…",
    "fetched_at": "2026-10-20T08:14:03Z",
    "stale": false,
    "error": null,
    "missing": { "<procedure-id>": ["secrets.MES_TOKEN"] }
  }
}

values is null when the station's state database cannot be opened.

How is this guide?

On this page