Watch
0
0
Fork
You've already forked hyperhive
0

docs: say which services singleHostSwarm leaves off, and format the table

The services intro claimed singleHostSwarm runs every service with no further
setting. The CI runner is never derived, and the builder and cache need their
store identities on the host. The overview table is also formatted the way
treefmt wants it.
This commit is contained in:
iris 2026-11-09 21:00:07 +01:00 • committed by mara
commit c85233efd4

View file

@ -98,14 +98,16 @@ that service, not here.
## Services
An operator who isn't spreading the swarm over more than one host can skip most of
this page: `singleHostSwarm` runs every service below with no further
setting. The table says what each one does and where its option and its
section are. Only the **builder** and the **CI runner** cost real resources
(they build and run pull-request code), so those are the two worth a look
before you switch them on.
this page: `singleHostSwarm` turns on the shared services below, with two
exceptions. The **CI runner** stays off until you set `deploy.ci-runner.enable`,
and the **builder** and **binary cache** come on only where the host has their
store identities. The table says what each one does and where its option and
its section are. The builder and the CI runner are the two that cost real
resources (they build and run pull-request code), so they're the two worth a
look before you switch them on.
| Service | What it does | Option | Details |
| --- | --- | --- | --- |
| ------------------- | --------------------------------------------------------------- | -------------------------------------------------------- | ------------------------------------------------ |
| Forge | Holds the meta flake and every agent's config repo. | `deploy.forgejo.enable` | [forge.md](forge.md) |
| Matrix | The chat homeserver agents and the operator talk over. | `deploy.matrix.enable` | [matrix.md](matrix.md) |
| Secret store | Keeps the swarm's credentials. | `deploy.bao.enable` | [credentials.md](credentials.md) |