PROVIDER Β· Lightweight self-hosted open source CI
Woodpecker CI
Woodpecker CI is the lightweight self-hosted CI forked from Drone's community edition whose single-binary server and agents run concise YAML pipelines, pairing with Gitea or Forgejo for a fully self-controlled code-to-deploy loop.
3.7pts
Pros
Cons
Product Information
Detailed Notes
Overview
Woodpecker CI forked from the Drone CI community edition in 2021 and is written in Go, keeping Drone's concise YAML pipelines while committing to fully open source community governance, supporting Gitea, Forgejo, GitLab, and GitHub.
For Developer Tools work the value is running CI from one container, since the server and agents are single binaries or images that a few low-spec machines can host, pipelines stay concise in YAML with steps executed in containers, and pairing with Gitea or Forgejo closes a fully self-controlled code-to-deploy loop.
The limits are ecosystem and scale, because the plugin market is far smaller than Jenkins or GitLab with limited complex orchestration, the community and Chinese material are small, and enterprise capabilities such as matrix builds, approvals, and auditing require building or switching.
Core Strengths
- Both server and agents are single binaries or images for simple deployment
- Apache 2.0 with community governance and no commercial feature gating
- Concise pipeline YAML with steps isolated in containers
- Native support for Gitea, Forgejo, GitLab, and GitHub
Product Ecosystem
Pipeline definition
Repositories declare steps in .woodpecker.yml with dependencies, parallelism, and service containers.
Runtime architecture
The server schedules work and renders the UI while agents execute container steps on target machines.
Platform integration
OAuth authorisation connects Gitea, Forgejo, GitLab, or GitHub so pushes and PRs trigger automatically.
Drawbacks
- Plugin and template ecosystem far smaller than Jenkins or GitLab CI
- Limited complex orchestration such as matrices and cross-repo dependencies
- Small community with scarce Chinese material and local support
- Enterprise auditing, approvals, and compliance need extra building
Use Cases
- Lightweight self-hosted CI (β β β β β ) - Runs from a single container
- Pairing with Gitea or Forgejo (β β β β β ) - A fully self-controlled stack
- Intranet and isolated environments (β β β β ) - Builds stay internal
- Complex enterprise pipelines (β β ) - Prefer GitLab CI
Pricing
| Plan | Price | Scope |
|---|---|---|
| Woodpecker open source | $0 | Apache 2.0, free self-hosting |
| Self-hosted server | Hardware and operations | Low-spec machines suffice |
| Third-party hosting | Monthly per instance | A few providers offer it |
Entirely free with cost in machines and effort, one small server plus agents scaled by concurrency, and compared with per-minute GitHub Actions, frequent builds usually pay back self-hosting within three to six months.
FAQ
-
How does it relate to Drone? It forked from the Drone community edition keeping concise YAML, after Drone moved to commercial licensing while Woodpecker stays fully open.
-
Can it run private builds? Yes, deploy it on the intranet with agents reaching only internal repositories for code that cannot leave the network.
-
Which Git platforms are supported? Gitea, Forgejo, GitLab, and GitHub, configured through OAuth.
Articles
- 01 GitLab CI/CD Best Practices: From Beginner to Production-Grade Pipelines 07-18
- 02 Prometheus Monitoring System Setup: From Metric Collection to Alert Notifications 07-18
- 03 'Ansible Automation Ops Guide: From Configuration Management to Application 07-18
- 04 Docker Beginner Tutorial: From Installation to Containerized Web Deployment 07-18
- 05 API Integration Guide: REST vs GraphQL Comparison and Selection 07-18
- 06 GitHub Actions CI/CD Tutorial: Automated Build, Test, and Deployment 07-18
- 07 Docker Compose Multi-Container Deployment: Building Complete Application Orchestration 07-18
- 08 Kubernetes Deployment Guide for Beginners: Building a K8s Cluster from Scratch 07-18
- 09 Best VS Code Extensions 2026: Boost Your Development Productivity 07-18
- 10 Frontend Toolchain 2026: Vite / Next.js / Tailwind CSS Ecosystem 07-18