woodpecker
★ 8.1kAbout
Community Ratings
No ratings yetNew this week
Read recap →Features
- CI/CD engine
- plugin extensibility
- plugin browsing
- translation interface
- self-hosted instance support
Details
- Last Updated
- Nov 3, 2026
- Created
- Apr 3, 2019
- Install Methods
- docker
- Requirements
- SQLite database
- Minimum Requirements
- RAM: 100 MB RAM (Server)
- Privacy & Independence
- No Cloud Required
- Deployment
Deployment: Docker Compose ✓2 Containers — light hosting footprintRuns as 2 containers
Run woodpecker yourself
Pick how much you want to manage.
HetznerBest match
Full control
A server with up to 1 GB of RAM, then Docker Compose.
About 20 minutes with Docker
DigitalOcean
Full control
A server with up to 1 GB of RAM, then Docker Compose.
About 20 minutes with Docker
OVHcloud
Full control
A server with up to 1 GB of RAM, then Docker Compose.
About 20 minutes with Docker
Is this your project? Sponsor a listing
Run woodpecker with Docker Compose
Compose file from the woodpecker project repository.
2 services · 2 unclassified (woodpecker-server, woodpecker-agent)
no resource limits declared
needs persistent storage (2 volumes)
docker-compose.example.yaml · @ dbb7056 · scanned Sep 24, 2026
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:
This file may be out of date. Check the woodpecker documentation for current setup steps.
Track your self-hosted stack
Bookmark software to try, rate tools you've used, and keep your collection in one place.