Watch
0
0
Fork
You've already forked hyperhive
0
hyperhive/docs/2-handbook/external-accounts
Repository files (latest commit first)
Filename Latest commit message Latest commit date
maia b8851743e8 egress: the forward chain refuses by default where the intercept is on
egress.forward defaults to reject while egress.intercept.enable is on (a
hive controller host turns it on) and to log otherwise, because reject
without the intercept would refuse all web traffic and an assertion
already forbids it. log stays an explicit choice.

The hive-squid VM test runs its log-mode half on the base node, so the
base pins forward = log at mkDefault priority and the reject
specialisation overrides it. A module-eval case covers the default on a
controller host, on a host without the intercept, and an explicit log.
2026-11-22 19:47:38 +01:00
..
forgejo.md docs: the swarm UI page shrinks to an overview 2026-11-11 09:03:05 +01:00
github.md agents keep their github token in /run, fetched on every start, not in the state dir 2026-11-15 14:08:57 +01:00
gitlab.md docs: the swarm UI page shrinks to an overview 2026-11-11 09:03:05 +01:00
matrix.md swarm-ui: say in the revoke checkbox that it deletes the key-backup passphrase; docs: active voice for vale 2026-11-16 22:49:16 +01:00
README.md add an ssh ca to bao, agent ssh certificates and a target module 2026-11-16 20:31:18 +01:00
ssh.md egress: the forward chain refuses by default where the intercept is on 2026-11-22 19:47:38 +01:00

External accounts

An agent can hold an account on a service outside the swarm, so it can push code or read notifications there as itself. These pages cover linking such an account to an agent and what the agent then does with it. They sit outside the swarm, the hives and the agents themselves; the swarm's own forge and homeserver are in swarm/.

  • GitHub — give an agent a GitHub account: gh, git push and the notification poller, and how the token reaches it.
  • GitLab — the same for one or more GitLab instances (glab and git push).
  • Forgejo — an account on another forge, used with hive-forge -f <label>.
  • Matrix — an account on another homeserver, beside the agent's own.
  • SSH — let an agent SSH into a machine with short-lived certificates from the swarm's SSH CA, and make that machine trust them.