History

Joshua Boniface ca86566698 Use enable instead of start		2023-02-05 00:29:59 -05:00
..
README.md	Use enable instead of start	2023-02-05 00:29:59 -05:00
bbuilder-api.service	Remove extra spaces around =	2021-10-31 01:12:07 -04:00
bbuilder-worker.service	Remove extra spaces around =	2021-10-31 01:12:07 -04:00
environment.example	Add support for SSH deploy key cloning	2021-10-31 02:11:57 -04:00

README.md

Example Systemd configuration for Basic Builder

This directory contains an example configuration set for running Basic Builder under systemd.

This presumes you've done a pip3 install . in the root of the repository (or in a virtualenv, etc.).

For demonstration purposes, the ExecStart path is /usr/local/bin/bbuilder, the EnvironmentFile is located at /etc/default/bbuilder, and that the User to execute as is named git.

Copy environment.example to /etc/default/bbuilder and edit it to suit your needs.

NOTE: This file contains the sensitive BB_AUTH_KEY value. Ensure this file is only readable by trusted users (e.g. mode 400)!
Copy bbuilder-api.service and bbuilder-worker.service into /etc/systemd/system.
Run sudo systemctl daemon-reload to load the changes to Systemd.
If applicable, create your service user.
Enable and start the API (sudo systemctl enable --now bbuilder-api.service) and Worker (sudo systemctl enable --now bbuilder-worker.service).
Configure your webhooks, etc.