Woodpecker Agent

Woodpecker Agent is the worker component of the Woodpecker CI/CD engine that executes automated build and test jobs.

  • Development
  • Tools & Utilities
Woodpecker Agent is the worker component of the Woodpecker CI/CD engine that executes automated build and test jobs. It connects to the main Woodpecker server to perform the actual work—such as compiling code or running tests—and reports the results back. Designed for distributed environments, it allows you to offload heavy CI/CD tasks to dedicated machines.

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

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