colimalisted

# Colima ## Overview Colima provides container and VM runtimes (Docker, Containerd, Incus) on macOS with minimal setup. It runs a Linux VM and exposes the chosen runtime to the host. **Use this skill when:** - Docker commands fail ("Cannot connect to Docker daemon") - Starting/stopping container runtime on macOS - Managing multiple Docker profiles/contexts - Troubleshooting container environment issues - Need SSH agent forwarding for Docker builds - Running incus on macOS (system containers or VMs with nested virtualization) **Not for:** Docker Compose or Kubernetes clusters. ## Quick Reference | Operation | Command | |-----------|---------| | Start | `colima start` or `colima start <profile>` | | Start with SSH agent | `colima start <profile> -s` | | Stop | `colima stop` or `colima stop --force` | | Status | `colima status -p <profile>` | | List profiles | `colima list` | | SSH into VM | `colima ssh` or `colima ssh -- <cmd>` | | SSH with chained commands | `colima ssh -- bash -c "cmd1 && cmd2"` | | Get socket path | `colima status -p <profile> --json \| jq -r .docker_socket` | ## Docker Context Basics Colima creates Docker contexts per profile: - Profile `default` → context `colima` - Profile `work` → context `colima-work` ```bash # Switch context (global - affects all terminals) docker context use colima-work # Override per-session export DOCKER_CONTEXT=colima-work # Override per-command docker --context colima-work ps ``` For details, see `references/docker-con