Woodpecker CI

Conteneur LXC DevScripts v3.19.0

Script en développement. À essayer sur une machine de test seulement.

Script en développement : le projet demande de ne pas l'utiliser en production.

Accès par défaut

Adresse: http://ADRESSE-IP:8000Remplacez ADRESSE-IP par l'adresse donnée à la fin de l'installation.
Compte et mot de passe: Aucun identifiant fixe publié par la source : voir ci-dessous.
Console et SSH: Console du conteneur dans l'interface Proxmox : compte root, connexion automatique sans mot de passe. Le SSH de root n'est ouvert que si vous l'avez demandé à l'installation.
Configuration: /opt/woodpecker_data/server.env

Registration is closed (WOODPECKER_OPEN=false): only the logins in WOODPECKER_ADMIN can sign in until an admin adds more users under Settings > Users.

Woodpecker CI is a simple, community-driven CI/CD engine. Pipelines are YAML files in the repository that run on push, pull request, tag, release, cron or manual events, with matrix builds, secrets, approvals for forks and a web UI with live logs. This script installs the official server and one agent with the local backend and SQLite, and connects it to Forgejo, Gitea, GitHub, GitLab or Bitbucket.

Site ↗ Documentation ↗ Dépôt de l'application ↗ Voir le code du script ↗

Installer

Cœurs: 2
Mémoire: 2 Go
Disque: 10 Go
Système: Debian 13

bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/DevScripts/main/ct/woodpecker-ci.sh)"

Configuration : /opt/woodpecker_data/server.env

Dans le shell du nœud Proxmox. Exécutez cette commande dans le shell du nœud Proxmox, pas dans une VM. Lisez le script d'abord.

Générateur : préparer la commande avec vos réglages

Remplissez seulement ce que vous voulez changer. Les valeurs vides gardent le réglage par défaut du script.

Cœurs Nombre de cœurs du conteneur. Mémoire (Mo) Mémoire vive en mégaoctets. Disque (Go) Taille du disque en gigaoctets. Nom de la machine Identifiant du conteneur Laissez vide pour le prochain identifiant libre. Pont réseau Pont ou réseau virtuel auquel brancher le conteneur. Adresse « dhcp » ou une adresse avec masque (10.64.250.10/24). Passerelle Seulement avec une adresse fixe. VLAN Stockage du conteneur Stockage des modèles Conteneur non privilégié Recommandé : oui. Accès SSH pour root Étiquettes Séparées par des points-virgules. Affichage détaillé

Tutoriel pas à pas

De l'interface de Proxmox jusqu'à la première connexion, pour Woodpecker CI.

Ouvrez l'interface de Proxmox dans votre navigateur et connectez-vous.
Dans l'arbre de gauche, cliquez sur votre nœud, puis sur « Shell ».
Vérifiez que le nœud a la place pour ce conteneur : 2 cœurs, 2 Go de mémoire, 10 Go de disque.

Copiez cette commande, collez-la dans le shell et appuyez sur Entrée.

bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/DevScripts/main/ct/woodpecker-ci.sh)"

À la question « Use Default Settings? », répondez oui pour garder les réglages par défaut. Répondez non pour choisir vous-même l'identifiant, l'adresse, le disque ou le réseau.
Attendez la fin de l'installation : le script affiche l'adresse du conteneur.
Ouvrez http://ADRESSE-IP:8000 dans votre navigateur, en remplaçant ADRESSE-IP par l'adresse affichée.
Pour entrer dans le conteneur : sélectionnez-le dans Proxmox, puis « Console ». La session root s'ouvre sans mot de passe.
Pour mettre à jour plus tard : tapez update dans la console du conteneur.
Le fichier de configuration se trouve ici : /opt/woodpecker_data/server.env

À savoir

Woodpecker CI has no local accounts, users sign in through the forge. Without the forge settings at install time, create an OAuth app on the forge with the callback URL http://<IP>:8000/authorize, fill in the forge block and WOODPECKER_ADMIN in /opt/woodpecker_data/server.env and run systemctl enable --now woodpecker-server woodpecker-agent.
WOODPECKER_HOST is set to http://<IP>:8000 and the forge must be able to reach it for webhooks. Forgejo and Gitea refuse webhooks to private addresses unless ALLOWED_HOST_LIST under [webhook] in their app.ini allows them; github.com, gitlab.com and Bitbucket Cloud need Woodpecker CI reachable from the internet. Change WOODPECKER_HOST and the OAuth callback URL together when the IP or domain changes.
The agent uses the local backend: pipeline steps run directly in this container as root, without isolation, so any pipeline can read the database with the users' forge tokens and the secrets in /opt/woodpecker_data. Only build repositories you trust.
With the local backend, image: names the shell (bash, sh) or a plugin executable, not a container image, so steps like image: golang do not work, and services: are not supported. Install the toolchains your pipelines need in the container. For container-isolated pipelines, add an agent with the Docker or Podman backend on another host, pointed at <IP>:9000 with WOODPECKER_AGENT_SECRET from server.env.
Everything that is not a binary lives in /opt/woodpecker_data: server.env and agent.env, the SQLite database woodpecker.sqlite and the agent ID in agent.conf. Back up /opt/woodpecker_data.

Options propres à ce script

Variable	Rôle	Type
`var_forge`	Forge	select
`var_forge_url`	Forge URL	text
`var_forge_client`	OAuth Client ID	text
`var_forge_secret`	OAuth Client Secret	password
`var_forge_admin`	Admin Users	text

Notes de la version v3.19.0

3.19.0 - 2026-10-07

❤️ Thanks to all contributors! ❤️

Special thanks to @vibushasatheeshkumar for reporting a security vulnerability!

@6543, @ChrisJr404, @KR-Ravindra, @LaGrunge, @cacarico, @chiliec, @confusedsushi, @grisu48, @healdropper, @hsdfat, @jagerman, @joseph0531, @lafriks, @mattwilkinsonn, @qwerty287, @roian6, @sb123sb123, @somaz94, @spatterIight, @tehlordvortex, @thiagola92, @tunglambk, @usiegj00, …

Alpine-IT-Tools

Conteneur LXC

IT-Tools is a web-based suite of utilities designed to streamline and simplify various IT tasks, providing tools for developers and system administrators to manage their…

Mise à jour Port 80

Alpine-Wakapi

Conteneur LXC

Wakapi is an open-source tool that helps you keep track of the time you have spent coding on different projects in different programming languages and more. Ideal for st…

Mise à jour Port 3000

AnythingLLM

Conteneur LXC

AnythingLLM is an all-in-one AI application: turn documents, websites and other content into a chat-ready knowledge base with RAG, agents and multi-user workspaces. It c…

Mise à jour Port 3001

ByteStash

Conteneur LXC

ByteStash is a self-hosted web application designed to store, organise, and manage your code snippets efficiently. With support for creating, editing, and filtering snip…

Mise à jour Port 3000

CLIProxyAPI

Conteneur LXC

CLIProxyAPI is a proxy server that provides OpenAI-compatible API endpoints for multiple AI CLI tools including Claude Code, Gemini CLI, OpenAI Codex, and more. It enabl…

Mise à jour Port 8317

Coder Code Server

Complément

Coder Code Server is an open-source project that enables you to run Visual Studio Code (VS Code) on a remote machine, such as a desktop PC or virtual server. It serves a…

Port 8680