bbuilder/systemd/README.md

22 lines
1.0 KiB
Markdown
Raw Normal View History

2021-10-31 00:51:38 -04:00
# 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`.
1. 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`)!
1. Copy `bbuilder-api.service` and `bbuilder-worker.service` into `/etc/systemd/system`.
1. Run `sudo systemctl daemon-reload` to load the changes to Systemd.
1. If applicable, create your service user.
1. Start the API (`sudo systemctl start bbuilder-api.service`) and Worker (`sudo systemctl start bbuilder-worker.service`).
1. Configure your webhooks, etc.