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