Your cellar. Your data. Your server.
CellarBoss is a free, open source wine cellar manager you host yourself. Keep track of every bottle, where it lives, when to drink it and what you thought of it.
Everything your cellar needs
Available on the web and on Android. Backed by SQLite, PostgreSQL or MySQL.
Wine database
Record country, region, grape, winemaker and vintage for every wine in your collection.
Learn moreImport from a link
Paste a link from The Wine Society, Naked Wines, Vivino and other shops to fill in a new wine for you.
Learn moreBottles and storage
Know exactly which rack, shelf or fridge each bottle is in.
Learn moreDrinking windows
Set a drinking window per vintage so you open bottles at their best, not after.
Learn moreTasting notes
Log ratings and notes each time you open a bottle and look back on them later.
Learn morePhotos
Upload label and bottle images so your collection is easy to browse at a glance.
Learn moreAsk your AI assistant
The built-in MCP server lets AI assistants answer questions about your cellar in plain English.
Learn moreSee it in action
These screenshots are captured automatically from the latest release.
Take your cellar with you
The Android app connects to your own CellarBoss server, so you can check what you have while you're in the wine shop or add a bottle the moment it arrives. It's in closed testing on Google Play, and an iOS build is on the wish list.
Read the mobile guide
Up and running in a minute
CellarBoss ships as Docker images for amd64 and arm64. Save this docker-compose.yml example and set a secret (openssl rand -base64 32 works). Then run docker compose up -d and open http://localhost:3000.
services:
backend:
image: ghcr.io/cellarboss/cellarboss-backend:latest
environment:
- BETTER_AUTH_SECRET=<super-secret-password>
- BETTER_AUTH_URL=http://localhost:3000
- DATABASE_TYPE=sqlite
- DATABASE_URL=/config/cellarboss.sqlite
- NODE_ENV=production
- CORS=http://localhost:3000
- UPLOAD_DIR=/uploads
volumes:
- ./data:/config
- ./uploads:/uploads
restart: unless-stopped
web:
image: ghcr.io/cellarboss/cellarboss-web:latest
ports:
- "3000:3000"
environment:
- CELLARBOSS_SERVER=http://backend:5000
- BETTER_AUTH_SECRET=<super-secret-password>
- BETTER_AUTH_URL=http://backend:5000
restart: unless-stoppedOpen source, and yours to keep
CellarBoss is licensed under the GPLv3. Your data lives on your server, in a database you choose, and nothing is sent anywhere else. Bug reports, feature ideas and pull requests are all welcome.
Roadmap
- ✓Multi-database support (SQLite, PostgreSQL, MySQL)
- ✓Upload images of your collection
- ✓Tasting notes
- ✓Import wine details from retailer and review websites
- Translations
- Build and publish styled wine menus
Questions
How do I get the mobile app?+
The Android app is in closed testing while it gathers the testers Google Play needs before a public release. If you'd like to help test, email contact@cellarboss.org. There's no iOS build yet because there are no Apple devices to test on. Help there is very welcome.
Is there a hosted version?+
Not at the moment. CellarBoss is built to be self-hosted, but a hosted option could be explored if there's enough interest.
Which databases are supported?+
SQLite, PostgreSQL and MySQL. SQLite needs no extra services and is the easiest place to start.
Can more than one person use it?+
Yes. Administrators can create user accounts with either an admin or a standard role, so a household or a restaurant team can share one cellar.
Can I use it commercially?+
Yes. The GPLv3 allows commercial use, as long as any modifications you distribute are released under the same licence. For a separate commercial arrangement, get in touch.
Something else? Open an issue on GitHub.