service
Register and manage the OwnLLM agent as a systemd / launchd / Windows service.
ownllm service install [--system]
ownllm service uninstall
ownllm service status
# Daemon lifecycle once registered
ownllm start
ownllm stop
ownllm restart [TARGET]ownllm service install registers the agent with the host's service
manager so it restarts on boot and survives logout. Without
--system, it installs a user-mode unit (no sudo); with
--system, it installs a system-wide unit (sudo / admin
required).
| OS | Unit |
|---|---|
| Linux (user) | ~/.config/systemd/user/ownllm.service |
| Linux (system) | /etc/systemd/system/ownllm.service |
| macOS (user) | ~/Library/LaunchAgents/ai.ownllm.cli.plist |
| macOS (system) | /Library/LaunchDaemons/ai.ownllm.cli.plist |
| Windows | A Service Control Manager entry called OwnLLM |
Lifecycle
After install, control the daemon through the OS service manager (or the CLI shortcuts that delegate to it):
ownllm start # systemctl --user start ownllm
ownllm stop # graceful shutdown over IPC
ownllm restart # restart all subprocesses
ownllm restart ollama # restart only Ollama
ownllm restart cloudflared # restart only the tunnel
ownllm restart gateway # restart only the OpenAI proxyrestart [TARGET] is targeted: it asks the supervisor to kill and
respawn just the named subprocess, so unrelated components keep
running.
Status
ownllm service statusPrints whether the OS service is registered, enabled (auto-start),
and currently active. This is the service view; for the agent
view (online/offline, models, runtimes), use status.
Uninstall
ownllm service uninstallStops the running daemon, deregisters the service file, and leaves
the binary and the keychain entries untouched. To wipe everything,
run ownllm unpair first.
When to use --system
- Production on a multi-user host where any login should expose the agent.
- Headless servers managed by a deploy tool.
Avoid --system on a personal Mac — the user-mode unit is enough and
keeps everything inside your home directory.