Skip to main content
Version: Next 🚧

Addons

Addons can be used to extend the Woodpecker server. Currently, they can be used for forges and the log service.

warning

Addon forges are still experimental. Their implementation can change and break at any time.

danger

You must trust the author of the addon forge you are using. They may have access to authentication codes and other potentially sensitive information.

Usage

To use an addon forge, download the correct addon version.

Forge

Use this in your .env:

WOODPECKER_ADDON_FORGE=/path/to/your/addon/forge/file

In case you run Woodpecker as container, you probably want to mount the addon binary to /opt/addons/.

List of addon forges

  • Radicle: Open source, peer-to-peer code collaboration stack built on Git. Radicle addon for Woodpecker CI can be found at this repo.

Log

Use this in your .env:

WOODPECKER_LOG_STORE=addon
WOODPECKER_LOG_STORE_FILE_PATH=/path/to/your/addon/forge/file

Developing addon forges

See Addons.