docs: add workspace registry installation manuals

2026-08-04 07:57:09 +02:00
parent 802b564200
commit 72e16dd5ea
6 changed files with 584 additions and 0 deletions
@@ -60,6 +60,15 @@ The frontend depends on the core health check and proxies `/health` and `/api/*`
 application health endpoint intentionally checks process readiness only; external dependency
 diagnostics are exposed by `tht doctor` and do not prevent the UI from starting.

+## Git-backed workspace registry
+
+Workspace descriptors are shared through a validated Git repository while endpoint bindings and
+secret files remain installation-local. Use the [local Mac/PC installation manual](docs/install/local-workspace-registry.md)
+for Docker Desktop or a local engine, and the [server installation manual](docs/install/server-workspace-registry.md)
+for the Gitea, reverse-proxy, backup, migration, and recovery workflow. The isolated deployment
+exercise is `./scripts/workspace-registry-smoke.sh`; both manuals are checked with
+`./scripts/verify-workspace-install-docs.sh --profile local` or `--profile server`.
+
 `docker-compose.dev.yml` is deliberately local: both published ports bind to `127.0.0.1`,
 `THT_SESSION_STORAGE=local`, and `THT_HOME=/data/local-home`. Do not set
 `THOTH_PUBLIC_EXPOSURE=true` for that profile; the backend rejects that public/local combination