Woodpecker Agent
Woodpecker Agent is the worker component of the Woodpecker CI/CD engine that executes automated build and test jobs.
Platform availability
Available on 2 of 10 platforms
- Unraid (not listed)
- TrueNAS
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
81/100 Excellent
- Maintained
- 100last commit 3 days ago
- Popular
- 788,232 GitHub stars
- Easy to install
- 452 install platforms, install notes, Docker image
- Light to run
- 10030 MB minimum RAM, runs on ARM
- Security check
- 68no serious findings, 3 minor, tests, OpenSSF Scorecard 6.3/10
Availability: platform listings confirmed today
- GitHub stars
- 8,232
- Open issues
- 377
- Last commit
- 2026-11-17
- Latest release
- v3.20.1
- License
- Apache-2.0
- Activity
- rising
Checked 3 days ago - source: GitHub (woodpecker-ci/woodpecker)
Resources & Compatibility
Minimum requirements: 30 MB RAM. ARM (e.g. Raspberry Pi) is supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Set WOODPECKER_HOST before starting Set WOODPECKER_HOST to a valid address that users and agents can reach. If it is malformed, Woodpecker exits during startup instead of running. source
Fetched 53 days ago - each note links to its source
Variants
Alternatives (7)
- Azure DevOps - Continuous Delivery Services for teams to share code, track work, and ship software – for any language, all in a single package.
- CircleCI - CircleCI provides development teams the confidence to build, test, and deploy—quickly and consistently—across numerous platforms.
- GitHub Actions - An experimental Docker image that runs self-hosted GitHub Actions runners with Docker support for CI teams whose jobs require containers.
- GitLab - GitLab is a self-hosted Git repository server and software delivery platform for individuals and teams to privately plan, version, build, t…
- Harness.io - Harness is a self-service CI/CD platform that allows engineers and DevOps to build, test, deploy, and verify software, on-demand.
- Jenkins - Jenkins is a fork of Hudson and is a continuous build system for software projects.
- semaphore - Semaphore is a modern web interface for managing DevOps tools such as Ansible, Terraform, OpenTofu, and PowerShell.
Checked 40 days ago - source: AlternativeTo
Common questions
How does a Woodpecker agent register with the server?
The agent connects to the server using the token from WOODPECKER_AGENT_SECRET when it starts. The server identifies the agent and registers it in its database if it has not connected before.
What WOODPECKER_HOST value is required before starting Woodpecker?
Set WOODPECKER_HOST to a valid address that users and agents can reach. If it is malformed, Woodpecker exits during startup instead of running.
Can I add my own Woodpecker agent to Codeberg without self-hosting the full CI stack?
Yes, you can add your own Woodpecker agents to your user or organization. Codeberg's shared CI resources are volunteer-run and have limitations.
How does Woodpecker execute pipeline steps?
Woodpecker uses Docker containers to execute pipeline steps. Plugins can extend the pipeline features beyond a normal Docker image.
Answers sourced from deepwiki.com, docs.codeberg.org, woodpecker-ci.org, woodpecker-ci.org
Community
Collected 48 days ago - public community threads