This document covers the installation steps for builds.sr.ht, a continuous integration service.

builds.sr.ht is comprised of two components: a master server and job runners. Typically, deployments have one master and many runners, which are distributed across multiple servers.

Note: For smaller deployments, job runners can be installed alongside the master server, but not without risk.

Installation

On the master server, install the builds.sr.ht package.

On each server hosting a job runner, install the builds.sr.ht-worker and builds.sr.ht-images packages.

Daemons
  • builds.sr.ht — The web service (master server).
  • builds.sr.ht-worker — The job runner.
Configuration

See Configuration.

Maintenance

To safely reboot a worker without dropping any running jobs, SIGINT the process and it will stop accepting new work and terminate once all existing jobs are completed.

About this wiki

commit aa91af4fa09eb84be3388f5d8ff4c5bb3059ae5e
Author: Runxi Yu <me@runxiyu.org>
Date:   2025-03-15T15:39:35+08:00

lists.sr.ht: HTML emails are rejected by most lists, not always

Signed-off-by: Runxi Yu <me@runxiyu.org>
References: https://git.sr.ht/~sircmpwn/lists.sr.ht/commit/d2470931a39c6816db9427abfd03b3b3093987e3
Clone this wiki
https://git.sr.ht/~sircmpwn/sr.ht-docs (read-only)
git@git.sr.ht:~sircmpwn/sr.ht-docs (read/write)