Overview
Commander can manage Docker containers within each workspace, letting you run services, databases, or development tools alongside your agents.For devcontainer-based development environments (Local Docker or GitHub Codespaces), see
Environments. This page covers manually managed containers added to
individual workspaces.
Adding a Container
Add containers to a workspace through the workspace detail view or via the manager:- Specify a Docker image (e.g.,
postgres:16,redis:7) - Configure port mappings to expose container ports to your host
- Set environment variables for configuration
- Mount volumes to persist data or share files with the worktree
- Optionally configure a health check command
Container Lifecycle
Pull Progress
When pulling a new Docker image, Commander shows real-time download progress so you know when the container will be ready.Viewing Logs
Access container logs from the workspace detail view. Logs update in real time for running containers.Health Checks
Configure health checks to monitor container readiness:- Command — The health check command to run inside the container
- Interval — How often to run the check
- Timeout — How long to wait for the check to pass
- Retries — How many consecutive failures before marking unhealthy
Container Actions
Containers are automatically cleaned up when you delete a workspace.