Home

Smart Drink Fridge

Smart Drink Fridge is a self-hosted inventory system for a drink fridge. It combines barcode scanning, stock tracking, product management, consumption statistics, price tracking, and optional smart-home integrations.

The application runs locally and stores its data in SQLite. Docker Compose is the recommended installation method.

Start here

• Installation — requirements and first start
• Configuration — all supported environment settings
• Using the application — products, barcodes, bookings, prices, and statistics
• User accounts and NFC — optional accounts, login, card assignment, and scanner policy
• Nextion display — scanner status, PIN login, wiring, and Raspberry Pi UART setup
• PWA and mobile installation — install the web interface as an app
• Tailscale and HTTPS — private HTTPS access from phones and other devices
• Updates — manual checks and optional one-click Docker updates
• Integrations — Home Assistant, Pushover, camera scanner, and buzzer
• Backups and data — SQLite storage, backups, and restore
• Security — deployment boundaries and Docker socket warning
• Troubleshooting — common setup and runtime problems

Current release

The current documented release is v1.3.8. See the GitHub releases for release notes and images.

Main capabilities

• Multiple barcodes and package quantities per product
• Camera-based barcode scanner
• Current stock and complete booking history
• Purchase prices and multiple currencies
• Financial statistics grouped by currency
• Consumption forecasts with estimated run-out dates
• Optional user accounts with personal consumption and cost tracking
• Optional PIN/password and NFC identification
• Optional Nextion status display with PIN login and latest-scan feedback
• Responsive German, English, and French interface
• Installable Progressive Web App
• Home Assistant shopping-list synchronization
• Optional Pushover notifications
• Optional Tailscale HTTPS access

Smart Drink Fridge is intended for a trusted private network. Do not expose the Flask service directly to the public internet.