Kegdisplay

Self-hosted homebrewing keg display. Shows 8 corny kegs with beer details on a beautiful dark dashboard. Built with FastAPI + SvelteKit + Docker Compose.

Quick Start

1. Clone the repo and cd kegdisplay
2. Generate your admin password hash:

   cd api && python hash_password.py yourpassword

3. Copy and fill in .env:

   cp .env.example .env
   # edit .env with your hash, a random JWT_SECRET, and your username

4. Start:

   docker compose up --build -d

5. Open http://localhost:3000 — add your kegs at http://localhost:3000/admin

Nginx Proxy Manager

Point your domain to http://<host>:3000. The frontend proxies /api to the backend automatically.

Editing a keg

Each keg supports: name, style (free text), ABV, volume, brew/tap dates, IBU, EBC, colour (picked via beer-style dropdown), notes, an Untappd link, and an optional recipe PDF (≤10 MB). Upload the PDF from the admin edit modal — it becomes clickable from the public display as a 📄 Recipe button that opens in an overlay.

PDFs live under /data/recipes/{id}.pdf on the keg_data volume and are included in the backup below.

.env gotcha: bcrypt $ escaping

Docker Compose interpolates $VAR references inside .env values. The bcrypt hash contains several $ characters, so each one must be doubled ($ → $$) in .env:

ADMIN_PASSWORD_HASH=$$2b$$12$$YourHashHere...

Or run this after pasting the raw hash:

sed -i '/^ADMIN_PASSWORD_HASH=/ s/\$/$$/g' .env

Verify the container receives the unescaped form ($2b$...):

docker compose exec api printenv ADMIN_PASSWORD_HASH

Backup

docker run --rm -v kegdisplay_keg_data:/data -v $(pwd):/backup alpine \
  tar czf /backup/kegs-backup.tar.gz /data

Future: Untappd Integration

See docs/plans/2026-04-15-kegdisplay-design.md — Future Features section.