woodpecker/docs/versioned_docs/version-3.13/30-administration/10-configuration/100-addons.md

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.