aboutsummaryrefslogblamecommitdiffstats
path: root/builds.sr.ht/installation.md
blob: 8c3485c75e107ee9021c7e60d912319055032bab (plain) (tree)
1
2
3
4
5
6
7
8
9
10
   
                                

   

                                                                          
 


                                                                             
 





                                                                              
 
              
 
                                                         
 

                                                                          
 
          
 

                                                   



                                      
---
title: builds.sr.ht Installation
---

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.

<div class="alert alert-info">
  <strong>Note:</strong> For smaller deployments, job runners can be installed
  alongside the master server, but
  <a href="/builds.sr.ht/configuration.md#security-model"
  class="alert-link">not without risk</a>.
</div>

# 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](configuration.md).