mara/hyperhive
mara/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Activity

seed a hyperhive/hyperhive mirror so update_meta finds it on a fresh swarm

Browse source
This commit is contained in:
atlas 2026-11-09 12:19:46 +01:00
commit a6b5bafa83
1 changed files with 173 additions and 15 deletions
Download patch file Download diff file Expand all files Collapse all files

15
docs/1-getting-started/nixos.md
View file

@ -85,6 +85,21 @@ services.hyperhive = {
Run `nixos-rebuild switch --flake .#my-host`. The swarm UI then answers at
`https://<swarm.domain>/`.
### The hyperhive mirror
The swarm controller pins the hive's flake inputs to a commit of hyperhive on
the swarm's own forge, so the forge needs a `hyperhive/hyperhive` repo before
the first agent builds. On a host that runs the forge and the controller,
the controller creates it as a pull-mirror of
`https://forge.darkest.space/hyperhive/hyperhive`. You run no extra step.
| option | what it does |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `deploy.forgejo.hyperhiveUpstream` | The clone URL the mirror pulls from. Set another URL to mirror a fork, or `null` to seed nothing and provide the repo yourself. The controller creates the mirror only if `hyperhive/hyperhive` doesn't exist, so a repo already there stays as it is. |
Without the repo, the first agent's `update_meta` job step fails with
`hyperhive/hyperhive is empty or absent on the swarm forge`.
## Everything else is optional
Leave the other options at their defaults until you need them: