Home

Smart Drink Fridge documentation

Smart Drink Fridge is a self-hosted inventory system for drink fridges. It combines barcode scanning, stock and product management, consumption and cost statistics, shopping lists, multiple locations, and optional smart-home and hardware integrations.

New: The native Smart Drink Fridge app for iPhone and Apple Watch is now available on the App Store.

The server runs locally with Docker Compose and stores its data in SQLite. The iOS app and web interface connect directly to the server you control.

Start here

• Installation — requirements, Docker installation and first start
• Configuration — environment settings and optional components
• Using the application — products, barcodes, bookings, prices and statistics
• iPhone and Apple Watch app — App Store download, connection and app features
• Multiple fridges and remote scanners — locations, edge devices, pairing and offline queues
• Hardware and barcode scanners — Raspberry Pi, camera, USB scanner and buzzer
• User accounts and NFC — accounts, roles, PIN login, card assignment and scan policy
• Nextion display — display setup, PIN login, wiring and UART configuration
• PWA and mobile installation — install the web interface as a browser app
• Tailscale and HTTPS — private HTTPS access for browsers and native apps
• Updates — release checks and optional one-click Docker updates
• Integrations — Home Assistant and Pushover
• Backups and data — SQLite storage, backups and restore
• Security — deployment boundaries and secrets
• Troubleshooting — common setup and runtime problems

Current versions

The latest stable server version is listed on GitHub Releases. The repository main branch may contain changes planned for the next release.

The iPhone and Apple Watch app is distributed free through the Apple App Store.

Main capabilities

• Multiple barcodes and package quantities per product
• Camera and USB barcode scanner support
• Multiple locations, stock transfers and remote scanner clients
• Current stock, booking history, prices and consumption forecasts
• Optional accounts with personal statistics, PIN/password and NFC identification
• Responsive web interface in 19 languages
• Native iPhone app, widgets, Live Activities and Apple Watch companion
• Optional Nextion display and Raspberry Pi host controls
• Home Assistant shopping-list synchronization and Pushover notifications
• Automatic backups, update checks and 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.