BarKeep
A home bar inventory tracker. Built with Rails, runs in Docker.
What it does
- Track bottles, ingredients, and supplies with quantities and images
- Categorize items (spirits, mixers, syrups, etc.)
- Low stock and out-of-stock alerts
- Filter and search across your inventory
- Multi-user with admin, regular, and read-only guest accounts
- Dark/light theme, works on mobile
Running with Docker
# Generate a secret key
docker run --rm ghcr.io/nckslvrmn/bar_keep:latest rails secret
# Run it
docker run -d \
--name barkeep \
-p 3000:3000 \
-v $(pwd)/storage:/app/storage \
-e SECRET_KEY_BASE=<your-secret-key> \
-e ALLOWED_HOST=barkeep.yourdomain.com \
-e FORCE_SSL=false \
ghcr.io/nckslvrmn/bar_keep:latest
The database is created and migrated automatically on first boot.
Docker Compose
See compose.yml in the repo for an example. Set your env vars and run:
docker compose up -d
Environment variables
| Variable | Required | Description |
|---|---|---|
SECRET_KEY_BASE |
Yes | Generate with rails secret |
ALLOWED_HOST |
No | Hostname for production (default: localhost) |
FORCE_SSL |
No | Set false if behind a reverse proxy (default: true) |
RAILS_ENV |
No | Default: production |
Image tags
latest— most recent releasevX.Y.Z— pinned version
Development
Requires Ruby 4.0+ and SQLite3.
bundle install
rails db:setup
rails server
Running checks
bin/rubocop # lint
bin/brakeman # security scan
bin/rails test # tests
Default login
After db:seed:
- Username:
admin - Password:
changeme123
Change this after first login.
Data
Everything lives in ./storage — SQLite databases, uploaded images, session data. Back this up and mount the same volume when updating containers.