docs(dev-sso): add three-repo dev-sso runbook + design rationale #23

Merged
longjacksonle merged 1 commit from docs/dev-sso-runbook into main 2026-05-31 20:09:57 +02:00

Document how the Traefik-routed dev SSO stack works across bunyip, mokosh-server, and mokosh-apps: the DNS-to-dev-01 vs run-on-desktop-02-over-Nebula topology, the two Traefik entrypoints (web-secure LAN vs nebula-secure mesh), the design rationale (per-developer hostnames, why the OIDC client is registered once and its PKCE purpose, external network + recipe pre-create, list-syntax labels for the ${USER} interpolation bug, HOST_UID/HOST_GID bind-mount perms, on-disk OIDC keys, the transitional dual-issuer wiring), the ordered spin-up procedure, Mac client-side access (/etc/hosts + Chrome DoH + Mailpit tunnel), and every obstacle hit with root cause and fix. Link it from CLAUDE.md.

Co-Authored-By: Claude Opus 4.8 (1M context) noreply@anthropic.com

Document how the Traefik-routed dev SSO stack works across bunyip, mokosh-server, and mokosh-apps: the DNS-to-dev-01 vs run-on-desktop-02-over-Nebula topology, the two Traefik entrypoints (web-secure LAN vs nebula-secure mesh), the design rationale (per-developer hostnames, why the OIDC client is registered once and its PKCE purpose, external network + recipe pre-create, list-syntax labels for the ${USER} interpolation bug, HOST_UID/HOST_GID bind-mount perms, on-disk OIDC keys, the transitional dual-issuer wiring), the ordered spin-up procedure, Mac client-side access (/etc/hosts + Chrome DoH + Mailpit tunnel), and every obstacle hit with root cause and fix. Link it from CLAUDE.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
docs(dev-sso): add three-repo dev-sso runbook + design rationale
Some checks failed
Create release / Create release from merged PR (pull_request) Has been skipped
Check / fmt / clippy / build / test (pull_request) Failing after 10s
b31c85d86c
Document how the Traefik-routed dev SSO stack works across bunyip, mokosh-server, and mokosh-apps: the DNS-to-dev-01 vs run-on-desktop-02-over-Nebula topology, the two Traefik entrypoints (web-secure LAN vs nebula-secure mesh), the design rationale (per-developer hostnames, why the OIDC client is registered once and its PKCE purpose, external network + recipe pre-create, list-syntax labels for the ${USER} interpolation bug, HOST_UID/HOST_GID bind-mount perms, on-disk OIDC keys, the transitional dual-issuer wiring), the ordered spin-up procedure, Mac client-side access (/etc/hosts + Chrome DoH + Mailpit tunnel), and every obstacle hit with root cause and fix. Link it from CLAUDE.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
longjacksonle deleted branch docs/dev-sso-runbook 2026-05-31 20:09:57 +02:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
psa-systems/bunyip!23
No description provided.