A small and light tool to help with FreeBSD Ports CI (Continuous Integration) https://ports.bluelife.at/
Go to file
Bernhard Fröhlich 25fa9d4560
Update go dependencies
2023-11-17 06:52:20 +00:00
assets Remove hardcoded links to github 2023-02-17 14:31:08 +00:00
cmd/caronade Move project to codeberg.org 2023-01-09 21:53:37 +00:00
configs Add support for Status API on Forgejo and Gitea 2023-02-17 15:20:19 +00:00
internal/server Fix code formatting 2023-02-17 19:13:03 +00:00
.woodpecker.yml Switch CI image to alpine 2023-01-09 21:43:19 +00:00
LICENSE Update copyright year and name 2019-06-06 14:01:08 +00:00
Makefile Update ETCDIR default path 2020-04-02 12:38:06 +00:00
README.md Add Forgejo and Gitea setup instructions to README 2023-02-17 19:10:20 +00:00
go.mod Update go dependencies 2023-11-17 06:52:20 +00:00
go.sum Update go dependencies 2023-11-17 06:52:20 +00:00



Go Report Card

A small and light tool to help with FreeBSD Ports CI (Continuous Integration).

Caronade will automatically create build jobs using poudriere and portlint whenever you push changes to your Git based ports repository.

Main features

  • Simple to setup and maintain
  • Works with Forgejo, Gitea and GitHub (Webhooks, Status API)
  • Poudriere support for building
  • Portlint support to verify port files
  • EMail notifications
  • Built-in webserver for Web UI and logfiles with HTTPS support

Getting Started

Caronade has an embedded HTTP(S) server which can receive Webhooks and shows your build status and build logs. It will execute a Makefile which runs the poudriere build so it expects that you have poudriere running successfully on the same machine. Each poudriere jail needs to have his own portstree to be able to run jobs in parallel.


  • git repository (Forgejo, Gitea or GitHub) with your ports
  • poudriere on ZFS
  • caronade needs to be reachable from the Internet


There is a FreeBSD port available as ports-mgmt/caronade.

pkg install caronade


Edit /usr/local/etc/caronade/caronade.yaml as needed.

Setup: Webhook

Create a new repository which only contains your ports (avoid forking the full FreeBSD portstree) on Forgejo, Gitea or GitHub.

A webhook needs to be created which does a HTTP POST request to your caronade daemon.

Create the webhook from the repository webinterface

repository settings -> webhooks -> add webhook
  payload url: baseurl from caronade
  content type: application/json
  secret: same as below
  events: Just the push event

Test the webhook by pushing a commit to the repository.

Setup: Status API (optional)

If you want caronade to integrate into the webinterface for your repository then you need to create a API Token for that.

Forgejo/Gitea: user settings -> applications -> generate token
GitHub: user settings -> developer settings -> personal access tokens -> repo:status

The token needs to be set in caronade.yaml.


Caronade parses the commit message and expects all commit messages to start with category/portname which it will use to generate build jobs. If the commit message contains a line CI: yes|no build jobs will be generated for all or no queues. Per default if no such line is found build jobs are generated for all queues specified in default_queues in caronade.yaml.

Remote builders

It's also possible to run build jobs on a remote machine as long as a SSH connection is available and caronade is also installed on both machines. For security reasons please create a dedicated ssh key for this connection.


Host builder-azure
  User root
  HostName <VM-HOST-NAME>.cloudapp.azure.com
  IdentityFile ~/.ssh/id_rsa_<VM-SSH-KEY>

/etc/ssh/sshd_config: (on builder-azure)

# caronade


- name: 13.1/amd64
  recipe: ssh
    SSH_HOST: builder-azure
    SSH_RECIPE: poudriere
    JAIL_NAME: 131amd64
    PORTSTREE: 131amd64

- name: portlint
  recipe: ssh
    SSH_HOST: builder-azure
    SSH_RECIPE: portlint
    PORTSDIR: /usr/local/poudriere/ports/default


Why caronade?

FreeBSD Ports are a great and huge collection of 3rd party sofware. For people working with ports it is very monotonous to do a lot of build testing to verify that your changes/new port builds fine in many different combinations (FreeBSD versions, architectures, Port options etc.).

Caronade does the testing for you while you continue with your work.

Is this redports?

Redports was an attempt to run a fully hosted FreeBSD Ports building service for everyone. Sadly it was also very complex, hard to maintain and time consuming to operate which is why it was discontinued after a few years. Caronade is an attempt to build a similar tool but as simple as possible and for your own poudriere machine. So caronade is not a fully hosted service.