Woodpecker CI

GitHub stats

Stars

8,031

Forks

718

Open issues and pull requests

391

Last push

2026-10-22

Latest release

v3.19.0

Released

2026-10-07

From the GitHub API on 2026-10-22. These numbers are a snapshot, not live. GitHub detected the license as Apache-2.0.

Compose file

version: '3'

services:
  woodpecker-server:
    image: woodpeckerci/woodpecker-server:v3
    ports:
      - 8000:8000
    networks:
      - woodpecker
    volumes:
      - /var/lib/woodpecker:/var/lib/woodpecker/
    environment:
      - WOODPECKER_OPEN=true
      - WOODPECKER_ADMIN=laszlocph
      - WOODPECKER_HOST=${WOODPECKER_HOST}
      - WOODPECKER_GITHUB=true
      - WOODPECKER_GITHUB_CLIENT=${WOODPECKER_GITHUB_CLIENT}
      - WOODPECKER_GITHUB_SECRET=${WOODPECKER_GITHUB_SECRET}
      - WOODPECKER_AGENT_SECRET=${WOODPECKER_AGENT_SECRET}
  woodpecker-agent:
    depends_on:
      woodpecker-server:
        condition: service_healthy
    image: woodpeckerci/woodpecker-agent:v3
    networks:
      - woodpecker
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - WOODPECKER_SERVER=woodpecker-server:9000
      - WOODPECKER_AGENT_SECRET=${WOODPECKER_AGENT_SECRET}
      - WOODPECKER_MAX_WORKFLOWS=2

networks:
  woodpecker:

From the app's own repository: github.com/woodpecker-ci/woodpecker/blob/aca84ce/docker-compose.example.yaml.

Compose file from the app repository.

Install

1. Docker with the Compose plugin (github.com/woodpecker-ci/woodpecker/blob/aca84ce/docker-compose.example.yaml)

   A host with Docker and the Docker Compose plugin. This entry runs from a compose file.

2. Save the compose file as compose.yaml (github.com/woodpecker-ci/woodpecker/blob/aca84ce/docker-compose.example.yaml)

   Use the compose file shown above.

3. Set the values the compose file needs (github.com/woodpecker-ci/woodpecker/blob/aca84ce/docker-compose.example.yaml)

   These variables have no default in the compose file: WOODPECKER_AGENT_SECRET, WOODPECKER_GITHUB_CLIENT, WOODPECKER_GITHUB_SECRET, WOODPECKER_HOST. Compose reads them from the shell or from a .env file next to the compose file.

4. Start it (github.com/woodpecker-ci/woodpecker/blob/aca84ce/docker-compose.example.yaml)

   docker compose up -d

5. Open the app (github.com/woodpecker-ci/woodpecker/blob/aca84ce/docker-compose.example.yaml)

   Open http://localhost:8000. The compose file publishes host port 8000 for the woodpecker-server service.

Compose file check: config_ok on 2026-10-22.

Gotchas and maintenance

Gotchas

• The compose file publishes host ports. Host ports: 8000 (woodpecker-server). A port without a host address listens on all host network interfaces. (github.com/woodpecker-ci/woodpecker/blob/aca84ce/docker-compose.example.yaml, checked 2026-10-22)
• The compose file mounts host folders. Host paths mounted into containers: /var/lib/woodpecker at /var/lib/woodpecker/ (woodpecker-server). (github.com/woodpecker-ci/woodpecker/blob/aca84ce/docker-compose.example.yaml, checked 2026-10-22)
• Some services get elevated host access. woodpecker-agent mounts the Docker socket, which gives it control of Docker on the host. (github.com/woodpecker-ci/woodpecker/blob/aca84ce/docker-compose.example.yaml, checked 2026-10-22)

Signals

• Open issues and pull requests: 391
• Last push: 2026-10-22 (0 days before this page was built)
• Latest release: v3.19.0 on 2026-10-07 (14 days before this page was built)