Skip to main content

Docker backend

This is the original backend used with Woodpecker. The docker backend executes each step inside a separate container started on the agent.

Configurationโ€‹

WOODPECKER_BACKEND_DOCKER_NETWORKโ€‹

Default: empty

Set to the name of an existing network which will be attached to all your pipeline containers (steps). Please be careful as this allows the containers of different pipelines to access each other!

WOODPECKER_BACKEND_DOCKER_ENABLE_IPV6โ€‹

Default: false

Enable IPv6 for the networks used by pipeline containers (steps). Make sure you configured your docker daemon to support IPv6.

Podman supportโ€‹

While the agent was developped with Docker/Moby, Podman can also be used by setting the environment variable DOCKER_SOCK to point to the podman socket. In order to work without workarounds, Podman 4.0 (or above) is required.