feat: add Dockerfile, docker-compose, and self-hosting guide#374
Merged
Conversation
Enables single-command self-deployment of the authsome daemon in a container without requiring Python or uv on the host. - Multi-stage Dockerfile: ui-builder (Node 24/pnpm) → py-builder (uv wheel) → slim Python 3.13 runtime, non-root authsome user - docker-compose.yml with named volume and restart: unless-stopped - .dockerignore to keep the build context minimal - docs/guides/self-hosting.md covering quick-start, env vars, volume backup/restore, TLS with Caddy, and local builds - .github/workflows/docker.yml CI job that builds the image on every PR - README.md self-hosting quick-start section Closes #366 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Dockerfile— three-stage build:ui-builder(Node 24 + pnpm compiles the Next.js dashboard),py-builder(uv builds the Python wheel),runtime(slim Python 3.13, non-rootauthsomeuser)docker-compose.yml— single service, named volume at/data/authsome,restart: unless-stopped, commented Caddy/Traefik TLS snippet.dockerignore— excludes.git,node_modules,dist/, test files, and editor artefacts to keep build context smalldocs/guides/self-hosting.md— quick-start, full env-var reference, volume backup/restore, TLS with Caddy, local build instructions.github/workflows/docker.yml— CI job that builds the image (no push) on every PR and push, with GHA layer cacheREADME.md— new "Self-hosting" section with a two-line quick-start pointing to the guideTest plan
docker build -t authsome:local .completes without errorsdocker compose up -dstarts the daemon;curl http://localhost:7998/healthreturns 200docker compose down && docker compose up -dCloses #366
🤖 Generated with Claude Code