From 963e49214d0bb36b68f57b1e653a387d5ce5bfd8 Mon Sep 17 00:00:00 2001 From: James Reilly Date: Thu, 29 Oct 2026 22:57:54 +0000 Subject: [PATCH] docs(hive): the hives run fork-built tuna/v6 binaries via compose.override.yaml Since 2026-10-29 each Spindle hive service mounts /srv/hives/bin/hive- from tuna-os/hive's tuna/v6 branch, chosen in /srv/hives/compose.override.yaml. Document how to check which binary runs, how to roll back, where the v5->v6 data snapshots are, and that hive.yaml.runtime (not the seed) is the live config. Tracker: tuna-os/tunaOS#4072. Signed-off-by: James Reilly --- docs/src/cluster/hive.md | 23 ++++++++++++++++++----- 1 file changed, 18 insertions(+), 5 deletions(-) diff --git a/docs/src/cluster/hive.md b/docs/src/cluster/hive.md index a63b4268..d3bead31 100644 --- a/docs/src/cluster/hive.md +++ b/docs/src/cluster/hive.md @@ -13,12 +13,25 @@ Caddy configuration routes [school.tunaos.org](https://school.tunaos.org) and state alone does not establish that the public endpoints or agents are healthy. The configured images are `ghcr.io/hivecommons/hive:v6-latest` for the two -spokes and `ghcr.io/hivecommons/hive-hub:v6-latest` for the hub. The Compose -services bind-mount `/srv/hives/bin/hive` over `/usr/local/bin/hive`, so the -image tag alone does not describe the running binary. The observed school and -reef seed configurations use the `omp` backend with +spokes and `ghcr.io/hivecommons/hive-hub:v6-latest` for the hub, but the image +tag does not describe the running binary. Since 2026-10-29, +`/srv/hives/compose.override.yaml` bind-mounts a fork-built binary, +`/srv/hives/bin/hive-`, over `/usr/local/bin/hive` in each service. +The binaries are built for arm64 from the `tuna/v6` branch of +[tuna-os/hive](https://github.com/tuna-os/hive): upstream `v6` plus the +features Tuna OS pilots on these hives. The fork's `FORK.md` records which +commit each service runs and its patches. To check a service, compare +`docker exec hives--1 sha256sum /usr/local/bin/hive` with +`sha256sum /srv/hives/bin/hive-`. Rollback is to point the service at +the previous binary in the override file and run `docker compose up -d `; +data snapshots from before the `v5` to `v6` change are in `/srv/hives/backups/`. + +The school and reef configurations use the `omp` backend with `github-copilot/gpt-6-luna`, not the historical pi/DeepSeek backend below. -Runtime state and model selection may differ from the seed files. +Each hive's live configuration is `/srv/hives//data/hive.yaml.runtime`, +which the hive restores over its seed (`/config/hive.yaml`) on start, so +stop the service before editing the runtime file. The rollout these hives run +is tracked in [tuna-os/tunaOS#4072](https://github.com/tuna-os/tunaOS/issues/4072). The old AWS cluster also had a `hive.reilly.asia` spoke; no hanthor container was present in the inspected Spindle Docker inventory. Its current status was