Skip to content
GantryCD

Docker

At a glance — a self-hosted launcher that runs each ephemeral runner as a container. Use it when you want per-run isolation on a single host.

Configure

On top of the shared runner-group config:

VariableRequiredNotes
DOCKER_IMAGEYescontainer image for the runner
DOCKER_SOCKETNo/var/run/docker.sock
DOCKER_MEMORYNomemory limit (suffixes supported)
DOCKER_CPUSNoCPU limit (positive float)
DOCKER_CONTAINER_BACKEND_URLNoBACKEND_URL as seen from inside the container, if the group’s own URL is unreachable there
DOCKER_IMAGE_PULL_POLICYNoalways | missing | never (default missing)
DOCKER_REGISTRY_AUTHNobase64 X-Registry-Auth for a private registry
make run_runner_group_docker

How it behaves

  • The create API never pulls, so a missing image fails every launch unless DOCKER_IMAGE_PULL_POLICY allows a pull.
  • Finished containers are swept on REAP_INTERVAL (default 5m); tune REAP_GRACE_PERIOD / REAP_KEEP_LATEST_FAILED to keep logs around for post-mortems.

Internals

Configuration → Docker Launcher.