Try describing what you need:

woodpecker logo

woodpecker

★ 8.1k
Apache License 2.0Open Source — No Paywall2 Containers — 2 containers — light hosting footprintDockerNo external DB55+ active committers (12mo)

About

Woodpecker is a self-hosted CI/CD engine designed for teams that want a lightweight but extensible automation system for building, testing, and deploying software. The README positions it as a simple...

Community Ratings

No ratings yet

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.

1 more way to host

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.

Metadata extracted from README on Aug 4, 2026

Alternatives to woodpecker

pikoci logo

pikoci

171
PikoCI is a self-hosted CI/CD system that runs as a single binary with pluggable database and queue backends.
Automation ToolsTask RunnersSelf Hosting Solutions
4 Containers
Details
openship logo

openship

15.1k
Openship is an open-source, self-hostable deployment platform with built-in CI/CD that can build, ship, route, and TLS-terminate apps from a desktop app, web dashboard, or CLI.
Platform as a ServiceAutomation ToolsSelf Hosting Solutions
5 Containers
Details
OneDev logo

OneDev

15.3k
All-In-One DevOps Platform. With Git Management, Issue Tracking, and CI/CD. Simple yet Powerful.
Dev Project ManagementPermissive LicenseAutomation Tools+1
Details
flowctl logo

flowctl

344
An open-source self-service workflow execution platform for running and managing complex workflows.
Automation ToolsTask RunnersSelf Hosting Solutions+2
4 Containers
Details

Related Software

Gitea logo

Gitea

58.8k
A self-hosted Git service for managing repositories, issues, pull requests, and related collaboration workflows.
Dev Project ManagementPermissive LicenseAutomation Tools+1
Details
Gogs logo

Gogs

47.9k
Gogs is a simple, stable, extensible self-hosted Git service that can be set up with an independent binary across platforms.
Dev Project ManagementPermissive LicenseSelf Hosting Solutions+1
Details
Gerrit logo

Gerrit

1.2k
Gerrit is a code review and project management tool for Git-based projects.
Dev Project ManagementSelf Hosting SolutionsPermissive License
Details
SCM Manager logo

SCM Manager

184
A self-hosted web application for sharing and managing Git, Mercurial, and Subversion repositories.
Dev Project ManagementPermissive LicenseSelf Hosting Solutions
Open Core
Details
Automatisch logo

Automatisch

14.0k
Automatisch is an open-source business automation tool for connecting services and automating workflows.
Automation ToolsCopyleft LicenseLow Code Development+1
4 ContainersOpen Core
Details
Cloud Seeder logo

Cloud Seeder

199
A one-click server appliance wizard for self-hosting containerized applications.
Self Hosting SolutionsAutomation ToolsPlatform as a Service
Source AvailableCloud Required
Details
autokitteh logo

autokitteh

1.1k
AutoKitteh is a developer platform for building durable, code-based workflow automations and orchestrations in Python, Starlark, and JavaScript.
Low Code DevelopmentPermissive LicenseAutomation Tools+2
Details
once logo

once

2.0k
ONCE is a platform for installing and managing Docker-based web applications, with automatic updates, backups, and a TUI/CLI for self-hosting operations.
Self Hosting SolutionsAutomation ToolsPlatform as a Service
Details
Harbor logo

Harbor

29.7k
Harbor is an open source cloud native registry for storing, signing, scanning, and replicating container images and Helm charts.
File & Object StoragePermissive LicenseSelf Hosting Solutions+2
3 Containers
Details
Apache Airflow logo

Apache Airflow

47.4k
Apache Airflow is a platform for programmatically authoring, scheduling, and monitoring workflows. It is used to orchestrate data pipelines, machine learning workflows, and other batch-oriented automation.
Automation ToolsPermissive LicenseTask Runners
Details
DOCAT logo

DOCAT

912
Docat is a self-hosted tool for hosting multiple documentation projects with multiple versions.
Miscellaneous ToolsDocument ManagementKnowledge Management+3
Details
Canine logo

Canine

2.9k
Canine is a self-hosted Kubernetes deployment platform that simplifies PaaS-style application deployment and management on your own Kubernetes infrastructure.
Platform as a ServiceSelf Hosting SolutionsAutomation Tools+2
Details