olace

[ daemon & cli ]

Daemon overview

The Olace daemon is a small background service for Windows, macOS, and Linux. It keeps local AI and Remote Access available when the app is closed: it maintains the encrypted connection that makes your machine reachable, starts your local runtime on demand, manages models, and serves the Olace Bridge and the CLI.

The desktop app installs it automatically. You can also run it standalone on a machine with no app at all; see Headless setup.

Autostart

The daemon starts on login and restarts itself if it stops:

PlatformMechanism
Linuxsystemd user service olace-daemon.service, kept alive across logout
macOSlaunchd agent app.olace.daemon
WindowsTask Scheduler task OlaceDaemon, starts on logon

Manage it with the CLI:

olace service status
olace service restart
olace service install     # also offered during olace signin
olace service uninstall   # Olace will not silently reinstall it

olace run runs the daemon in the foreground instead, replacing the service instance. Useful for debugging.

Checking on it

olace status

Shows the service state, daemon version and uptime, whether the tunnel to Olace is connected, the Bridge state, loaded models, and your pairings. Add --json for scripts, or --device <host> to check a paired computer instead.

The daemon also answers on 127.0.0.1:5577 (loopback only) with /health and /status for local integrations.

Logs

olace logs             # recent entries
olace logs -f          # follow
olace logs --level warn --sub tunnel

The full log file lives at ~/.olace/logs/daemon.log.

Updating

olace update --check   # is there a newer version?
olace update           # download, verify, swap, restart

Updates are downloaded from the release manifest, verified by checksum, swapped atomically, and the service restarts itself. The previous binary is kept as a backup next to it.

Signing out

Signing out anywhere on a computer signs it out everywhere on that computer: the app, the daemon, and the CLI together. olace signout warns you before doing it and clears that computer's pairing and bridge state.