docs(backup): document MOKOSH_BACKUP_API_URL for teammates (BUNYIP-356) #358

Merged

longjacksonle merged 1 commit from docs/BUNYIP-356-mokosh-backup-url-runbook into main

2026-07-10 21:26:45 +02:00

longjacksonle commented

2026-07-10 20:43:42 +02:00

Owner

Summary

Account backup (BUNYIP-356) only activates when MOKOSH_BACKUP_API_URL is set; that was documented only in .env.example. This makes it discoverable where a teammate onboarding dev-sso actually looks, and fixes a misleading example value.

docs/dev-sso-three-repo-runbook.md: opt-in note in the spin-up section - set MOKOSH_BACKUP_API_URL=https://<user>-mokosh-api.a8n.run (same mokosh host as MOKOSH_WEBHOOK_URL) and re-up bunyip-api; unset keeps Mokosh "unavailable" per box; restore is gated on mokosh-server PMS-648.
compose.dev-sso.yml: pass MOKOSH_BACKUP_API_URL through to bunyip-api (defaults empty), so setting it in .env is sufficient.
.env.example: correct the example - it is the external mokosh Traefik host (mirroring MOKOSH_WEBHOOK_URL), not an internal docker service name; the two stacks talk over Traefik.

No code change; docs + one compose env passthrough.

🤖 Generated with Claude Code

## Summary Account backup (BUNYIP-356) only activates when `MOKOSH_BACKUP_API_URL` is set; that was documented only in `.env.example`. This makes it discoverable where a teammate onboarding dev-sso actually looks, and fixes a misleading example value. - **`docs/dev-sso-three-repo-runbook.md`**: opt-in note in the spin-up section - set `MOKOSH_BACKUP_API_URL=https://<user>-mokosh-api.a8n.run` (same mokosh host as `MOKOSH_WEBHOOK_URL`) and re-up bunyip-api; unset keeps Mokosh "unavailable" per box; restore is gated on mokosh-server PMS-648. - **`compose.dev-sso.yml`**: pass `MOKOSH_BACKUP_API_URL` through to bunyip-api (defaults empty), so setting it in `.env` is sufficient. - **`.env.example`**: correct the example - it is the external mokosh Traefik host (mirroring `MOKOSH_WEBHOOK_URL`), not an internal docker service name; the two stacks talk over Traefik. No code change; docs + one compose env passthrough. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

longjacksonle added 1 commit

2026-07-10 20:43:42 +02:00

docs(backup): document MOKOSH_BACKUP_API_URL for teammates (BUNYIP-356)

E2E / Playwright against deployment (pull_request) Successful in 11s

Details

Check / fmt + clippy + build + tests (pull_request) Successful in 42m59s

Details

Create release / Create release from merged PR (pull_request) Has been skipped

Details

994b5a287c

Account backup only calls Mokosh when MOKOSH_BACKUP_API_URL is set, and that was only noted in .env.example. Make it discoverable where a teammate onboarding the dev-sso stack actually looks:

- dev-sso runbook: an opt-in note in the spin-up section - set it to the mokosh-api Traefik host (same as MOKOSH_WEBHOOK_URL), re-up bunyip-api; unset keeps Mokosh "unavailable"; restore is gated on mokosh-server PMS-648.
- compose.dev-sso.yml: pass MOKOSH_BACKUP_API_URL through to bunyip-api (defaults empty) so setting it in .env is enough.
- .env.example: fix the example - it is the external mokosh host (mirroring MOKOSH_WEBHOOK_URL), not an internal docker name; the two stacks talk over Traefik.

No code change.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014gTWMeFYgEAiRKCV3L9jAb

longjacksonle scheduled this pull request to auto merge when all checks succeed

2026-07-10 20:44:55 +02:00