Skip to content

Part C: packaging for self-hosters (2.0.0) - #6

Merged
downlevel merged 1 commit into
mainfrom
sso-c
Oct 22, 2026
Merged

downlevel merged 1 commit into
mainfrom
sso-c

Conversation

@downlevel

Copy link
Copy Markdown
Owner
  • Release workflow: on vX.Y.Z tags only, builds linux/amd64 + linux/arm64 and pushes ghcr.io//telelogin: (+ latest for final releases only) with OCI labels; never runs on branches or PRs.
  • deploy/: image-only docker-compose.yml, .env.example (secrets empty; known placeholder secrets are rejected at startup), and docker-compose.docker-proxy.yml for proxies running in Docker (no published API port; API reachable as telelogin on the compose network).
  • Version 2.0.0 (FastAPI version, /health reports it).
  • README quick start from zero to a protected app, CHANGELOG.md with breaking changes and upgrade steps, SECURITY.md, CONTRIBUTING.md.
  • docs/INTEGRATION.md: explicit upstream per topology (host proxy vs Docker proxy) and release-install admin commands.
  • Part B follow-ups: fsync + clear hard-link error in OIDC key creation, deterministic concurrent key test, example logout Origin via APP_ORIGIN.

Built by Codex from the reviewed plan; inspected twice by fresh Claude sessions (first: 5 findings fixed by Codex; second: APPROVED with four optional low findings). Verification: 169 tests pass (also with -W error), ruff and actionlint clean, compose configs valid; two fresh-user walkthroughs of the quick start (host Caddy; Traefik in Docker with the shipped example unmodified) completed a full login.

- Release workflow: on vX.Y.Z tags only, builds linux/amd64 + linux/arm64
  and pushes ghcr.io/<owner>/telelogin:<version> (+ latest for final
  releases only) with OCI labels; never runs on branches or PRs.
- deploy/: image-only docker-compose.yml, .env.example (secrets empty;
  known placeholder secrets are rejected at startup), and
  docker-compose.docker-proxy.yml for proxies running in Docker (no
  published API port; API reachable as `telelogin` on the compose network).
- Version 2.0.0 (FastAPI version, /health reports it).
- README quick start from zero to a protected app, CHANGELOG.md with
  breaking changes and upgrade steps, SECURITY.md, CONTRIBUTING.md.
- docs/INTEGRATION.md: explicit upstream per topology (host proxy vs Docker
  proxy) and release-install admin commands.
- Part B follow-ups: fsync + clear hard-link error in OIDC key creation,
  deterministic concurrent key test, example logout Origin via APP_ORIGIN.

Built by Codex from the reviewed plan; inspected twice by fresh Claude
sessions (first: 5 findings fixed by Codex; second: APPROVED with four
optional low findings). Verification: 169 tests pass (also with -W error),
ruff and actionlint clean, compose configs valid; two fresh-user
walkthroughs of the quick start (host Caddy; Traefik in Docker with the
shipped example unmodified) completed a full login.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@downlevel
downlevel merged commit ea91847 into main Oct 22, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant