Agent Types

A connected host showing its detected runtime backend and capabilities.

The agent supports pluggable container runtimes. Each agent uses a single runtime. Docker is the current runtime, and Kubernetes is planned.

Docker backend

The Docker backend is the current implementation. It reconciles the host’s Docker resources against the server’s desired state.

It manages:

• Containers: create, start, stop, recreate, and delete; resource limits.
• Networks: per-workspace networks, including macvlan.
• Volumes: creation, mounting, and persistence.
• Images: building and pulling.

The Docker backend connects to the local Docker daemon through the default Docker socket. Mount /var/run/docker.sock into the agent container so it can reach the daemon. See Agent Mode for how to run it.

Kubernetes backend

A Kubernetes backend is planned but not yet available. Today the only runtime is Docker.