Skip to content

EN Providers Docker

lkmavi edited this page Sep 24, 2026 · 1 revision

Docker provider

Docker is the default compute provider. whaleshell talks to the local Engine API (DOCKER_HOST / Desktop socket), creates an internal network per sandbox, starts an egress proxy sidecar, then starts the sandbox container.

Pages

Page Topic
Prerequisites Engine, Desktop VMM, images
Create a sandbox sandbox create / connect / delete
Resources and limits CPU, memory, PIDs, soft defaults
Logging Container log rotation, gateway rings
Troubleshooting Common failures

Layout (one sandbox)

host Docker Engine
├── whaleshell-<name>              sandbox (agent image)
├── whaleshell-proxy-<name>        egress sidecar (slim base)
├── whaleshell-net-<name>          internal network
├── whaleshell-data-<name>         optional data volume
└── whaleshell-ca-<name>           MITM CA volume (when proxy enabled)

Activate

unset WHALESHELL_DRIVER          # or: export WHALESHELL_DRIVER=docker
whaleshell doctor
whaleshell status

Expect driver: docker in status output.

→ New docs site

whaleshell

English

Русский

Clone this wiki locally