Woodpecker CI | Support by cloudimg

This is a repackaged open source software product wherein additional charges apply for cloudimg support services.

Overview Woodpecker CI is a simple, yet powerful open source continuous integration and delivery engine with great extensibility. Pipelines are defined as plain YAML in your repository and run each step in an isolated container, so builds are reproducible and easy to reason about. Because Woodpecker authenticates users against a Git forge rather than keeping its own user database, this image bundles the Gitea self-hosted Git service on the same instance and pre-wires the OAuth handshake between them, so a complete source-control and CI/CD pair is running within minutes of launch.

Application Stack The Woodpecker server, which serves the web UI and the gRPC endpoint that agents connect to, runs alongside a Woodpecker agent that executes pipelines with the Docker backend, and a bundled Gitea Git forge that provides repositories and OAuth login. Every application port binds to the loopback interface; nginx publishes the Woodpecker UI on port 80 and the bundled Gitea on port 3000.

Pre-wired OAuth Woodpecker signs users in through Gitea using OAuth2. This image creates the Gitea OAuth application automatically and feeds its client credentials into Woodpecker, so you simply sign in with the bundled Gitea administrator and you are taken straight into Woodpecker. Point Woodpecker at an external GitHub, Gitea, Forgejo or GitLab forge instead by editing one configuration file, as described in the user guide.

Secure First Boot On the first boot of your instance a one-shot service generates fresh Gitea server secrets, a fresh Woodpecker agent secret and a fresh OAuth client secret, all unique to that instance, rotates the Gitea administrator password, wires the OAuth callback and forge URLs to the instance address, and writes the login to a root-only file. Open registration is disabled. No shared or default credentials ship in the image.

Ready To Use Sign in with the generated administrator credentials, push a repository to the bundled Gitea, add a .woodpecker.yml pipeline, enable the repository in Woodpecker and watch the build run. The Woodpecker store and the Gitea repositories live on a dedicated, independently resizable data disk.

cloudimg Support 24/7 technical support by email and chat for deployment, pointing Woodpecker at an external forge, pipeline authoring, agent scaling, TLS termination and upgrades.

All product and company names are trademarks or registered trademarks of their respective holders. Use of them does not imply any affiliation with or endorsement by them.