Consolidate co-op/runbooks into co-op/ops-docs

Absorbs the Cloudron server-migration material from co-op/runbooks
(now archived) so there is a single public operator documentation
repository. Files move into migration/ (plan, DNS change sheet,
pre-migration state) and provider-pricing/ is kept as its own section;
the merged README replaces both.

History is preserved: this is a merge of the unrelated histories, so
co-op/runbooks' 26 commits remain reachable from this repository and
git log -- migration/ shows their real authors and messages. File
contents are byte-identical to co-op/runbooks (blob hashes unchanged).
This commit is contained in:
inference-bot committed 2026-11-03 23:34:03 +00:00
commit 11b10e2b03
5 files changed
+984 -7

No files matched your search

+41 -7
View File
@@ -2,9 +2,12 @@
Operator- and maintainer-facing documentation for the Inference Cooperative.
This is the material that describes how the co-op's infrastructure is run —
access tokens, scheduled tasks, maintenance procedures, and outage write-ups —
as opposed to the member-facing documentation published at
<https://docs.inference.coop/>.
access tokens, scheduled tasks, maintenance procedures, outage write-ups, and
the server-migration record — as opposed to the member-facing documentation
published at <https://docs.inference.coop/>.
Anyone may read it; operators are the audience. Comment, or open an issue,
where something looks wrong — that review is the point.
## This repository is deliberately not a website
@@ -24,16 +27,47 @@ Read it on the web here: <https://git.inference.coop/co-op/ops-docs>
| `maintenance/chat-task-models.md` | The small pinned model used for chat titles/tags/suggestions |
| `maintenance/librechat-sandbox.md` | Operating the LibreChat evaluation instance (config, overlay image, key sync, pitfalls) |
| `incidents/` | Post-incident write-ups, one file per incident |
| `migration/` | The Cloudron server-migration record: the plan, the DNS change sheet, and the captured pre-migration state |
| `provider-pricing/` | What our model providers charge, and when it changed |
## The migration material
`migration/` holds the record of moving Cloudron to its new server: the plan
([`cloudron-server-migration.md`](migration/cloudron-server-migration.md)),
the record-by-record cutover sheet
([`dns-change-sheet.md`](migration/dns-change-sheet.md)), and the captured
pre-migration state the restore checker compares against
([`migration-before-state.json`](migration/migration-before-state.json)).
**The migration is complete (2026-11-02)** — this material is kept as the
record of how it was planned and done, not as pending work. Current
operational procedure lives in the co-op's `cloudron-ops` skill; the
member-facing description lives in `co-op/docs/infrastructure.md`.
### Read the DNS sheet with this in mind
Its record counts **cannot be trusted until reconciled against the registrar's
panel.** The zone is wildcarded, so *any* hostname resolves — a name that
answers proves nothing about whether a record exists. At least two listed
records turned out not to exist, and the real record inventory is only visible
in the registrar's own list.
## No secrets here
Audited 2026-11-01, including the full commit history: no credentials, tokens,
keys, member emails or account identifiers. Where a runbook needs a credential
to exist (a backup passphrase, an S3 key), it records **where the credential is
held**, never the credential.
## Where operators look
- **Member-facing docs** live in [`co-op/docs`](https://git.inference.coop/co-op/docs)
and are published at <https://docs.inference.coop/>.
- **Migration runbooks** live in [`co-op/runbooks`](https://git.inference.coop/co-op/runbooks).
- The member-facing docs link here from their "For operators" section.
## History
These files were moved here from `co-op/docs`, where they were previously
published on the member-facing site. The commit history for each file is
preserved in this repository.
The operator runbook, maintenance pages and incident write-ups were moved here
from `co-op/docs`, where they were previously published on the member-facing
site. The migration material came from `co-op/runbooks` (now archived), and was
brought across with its commit history intact via an unrelated-histories merge.