From 695c6cfcf335c8f9144774e8c38a122fdc9cdda8 Mon Sep 17 00:00:00 2001 From: Inferencebot Date: Fri, 20 Nov 2026 02:12:31 +0000 Subject: [PATCH] docs: keep infrastructure page navigational, not implementation detail --- operations/infrastructure.md | 27 +++++++++------------------ 1 file changed, 9 insertions(+), 18 deletions(-) diff --git a/operations/infrastructure.md b/operations/infrastructure.md index a634677..7f7244c 100644 --- a/operations/infrastructure.md +++ b/operations/infrastructure.md @@ -43,10 +43,8 @@ stays an agent problem: it cannot reach the chat, the gateway or member data. Cloudron writes **encrypted** backups to Infomaniak's object storage in Switzerland every night and keeps the last **seven days**, so a failed upgrade -or a lost server can be restored. The automation host backs up its own data to -the same object storage; its backup credentials are root-only and never held by -the agent. Bucket versioning is enabled, so a deleted snapshot object remains -recoverable rather than vanishing. +or a lost server can be restored. The automation host keeps its own encrypted +backup as well, with credentials kept apart from the agent's environment. ### Domain and DNS @@ -217,23 +215,16 @@ private, loopback, and internal addresses. The independent and independently rotatable, so a leak has bounded scope. - **No secrets in version control.** Credentials live in the hosting platform's environment, never in the repos. -- **Least-privilege automation.** The steward agent runs as its own Unix user. - Host root access is limited to a small allowlist of docs and backup service - commands; package installs, user management and arbitrary root commands need - the operator. -- **Backup keys stay outside the agent.** The nightly backup credentials live in - a root-only file, not the agent's environment. -- **Machine feeds are signed.** The portal's chat-key feed is reachable only - from the internal network and requires a timestamped HMAC in addition to its - sync token. -- **CI is advisory, not a trust boundary.** Woodpecker runs in a shared root - container, so its status is visible but does not gate merges; Owners review is - the gate. The operator docs record the runner-isolation work. +- **Least-privilege automation.** The steward agent runs as its own Unix user; + host-level actions that need root are operator-controlled. - **Accepted trade-offs** (documented, not hidden): member keys are stored in the portal database so the co-op can serve them, and the API gateway must stay publicly reachable. Its admin surfaces are disabled; only the public API is - exposed. The automation host's remaining backup-timer root hardening is - tracked in operator docs. + exposed. +- **Operational detail lives with operators.** Token scopes, backup handling, + CI trust and host access are recorded in + [`co-op/ops-docs`](https://git.inference.coop/co-op/ops-docs), not on this + page. ## For operators