Installation

Installation

Requirements

• Raspberry Pi or another Linux host
• Docker Engine with the Compose plugin
• Network access for downloading container images
• Optional 1080p USB camera for barcode scanning
• Optional Tailscale account for private HTTPS access

Quick start

git clone https://github.com/DerRobin99/smart-drink-fridge.git
cd smart-drink-fridge
cp .env.example .env

Edit .env and replace at least:

SECRET_KEY=use-a-long-random-value
STORNO_PASSWORT=choose-a-password

Start the web interface:

docker compose up -d

Open:

http://SERVER-IP:5000

Optional scanner

The scanner profile expects a camera at /dev/video0:

docker compose --profile scanner up -d

Check that the device exists on the host:

ls -l /dev/video0

Optional NFC reader

The NFC service supports PC/SC readers such as the ACS ACR122U. Start it together with the camera scanner:

docker compose --profile scanner --profile nfc up -d

The nfc profile deliberately grants its container access to the host USB bus. Enable it only when NFC-based user selection is wanted. See User accounts and NFC before assigning cards.

Useful commands

docker compose ps
docker compose logs -f web
docker compose restart web
docker compose down

Persistent data is retained when containers are recreated. Continue with Configuration and Backups and data before using the system in production.