Skip to content

Overview

Plugins are special pipeline steps that perform pre-defined tasks. They simplify complex operations and provide security for sensitive credentials.

Why Use Plugins?

Plugins offer two key advantages over regular steps:

Security - Plugins cannot be altered in their execution. Combined with secret filtering, they prevent credential exposure in pull requests.
Simplicity - Complex operations become single-step configurations. No need to write shell commands for common tasks.

Quick Example

steps:
  - name: deploy
    image: codeberg.org/crow-plugins/docker-buildx
    settings:
      repo: myorg/myapp
      dockerfile: Dockerfile
      tags: latest

The settings key passes configuration to the plugin. Behind the scenes, each setting becomes a PLUGIN_ environment variable.

Learn More

Using Plugins - How to configure and use plugins in your workflows
Available Plugins - Directory of official and community plugins
Creating Plugins - Build your own plugins

Plugin Compatibility

Crow CI inherits plugin compatibility from Woodpecker CI and Drone CI:

Woodpecker plugins - Fully compatible
Drone plugins - Partially compatible; many use environment: instead of settings:, which is not allowed in Crow for security reasons