Local daemon

Responsibilities

The daemon is the local intermediary between the dashboard and the agents it runs.

• Stores agent configuration and runtime state.
• Builds and starts a Docker container for each agent.
• Proxies upstream calls so most credentials never reach the agent container.
• Serves a local HTTP API the dashboard talks to.

Docker access

The daemon uses Docker and Docker Compose to manage agent containers, so it needs access to the host Docker socket. The dashboard's docker run command bind-mounts /var/run/docker.sock to make this work.

Local-first runtime

Every agent container runs on the same machine as the daemon. Files, credentials, logs, and artifacts stay on that machine — the dashboard reads them on demand through the paired daemon.