Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
A lightweight CI/CD engine, forked from Drone, that runs pipelines defined in YAML as Docker containers. It has no user accounts of its own: you log in through a connected forge such as GitHub, Gitea, Forgejo or GitLab.
Runs on a VPS from $4/mo (Kamatera 1GB, 1 GB RAM) · prices checked Nov 2026
Fits home hardware (25 MB measured idle, RAM only): Raspberry Pi 4 (4 GB) (arm64 untested), Raspberry Pi 5 (8 GB) (arm64 untested), Repurposed laptop (8 GB), Intel N100 mini PC (16 GB), AMD Ryzen mini PC (32 GB).
Paid link — we earn a commission if you shop through it.
Run these commands on your server:
# Woodpecker server + agent — official compose (GitHub forge); create a GitHub OAuth app first,
# callback URL http://SERVER_IP:8000/authorize, and paste its client id + secret below
mkdir -p ~/woodpecker && cd ~/woodpecker
cat > .env <<EOF
WOODPECKER_HOST=http://SERVER_IP:8000
WOODPECKER_GITHUB_CLIENT=your-github-oauth-client-id
WOODPECKER_GITHUB_SECRET=your-github-oauth-client-secret
WOODPECKER_AGENT_SECRET=$(openssl rand -hex 32)
EOF
cat > docker-compose.yml <<'EOF'
services:
woodpecker-server:
image: woodpeckerci/woodpecker-server:v3
ports: ["8000:8000"]
volumes: ["woodpecker-server-data:/var/lib/woodpecker/"]
environment:
- WOODPECKER_OPEN=true
- 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:
image: woodpeckerci/woodpecker-agent:v3
command: agent
restart: always
depends_on: [woodpecker-server]
volumes: ["woodpecker-agent-config:/etc/woodpecker", "/var/run/docker.sock:/var/run/docker.sock"]
environment:
- WOODPECKER_SERVER=woodpecker-server:9000
- WOODPECKER_AGENT_SECRET=${WOODPECKER_AGENT_SECRET}
volumes:
woodpecker-server-data:
woodpecker-agent-config:
EOF
docker compose up -d
# open http://SERVER_IP:8000 and log in with GitHubWoodpecker CI used 25 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.2 (first boot, measured Oct 2026). We list a minimum of 256 MB.
The Woodpecker CI install snippet is marked verified on Ubuntu 26.04 (Oct 2026).