Installation

Installation

Requirements

• Raspberry Pi 3 Model B or newer, or another compatible 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

For the complete setup with camera scanning, NFC, the Nextion display, and Tailscale, a Raspberry Pi 3 Model B with 1 GB RAM is the tested minimum. A Raspberry Pi 4 with at least 2 GB RAM is recommended for new installations because it provides more headroom for barcode recognition, Docker updates, and future features. Raspberry Pi Pico boards do not run Linux or Docker, and older Raspberry Pi 2 models are not recommended for the full installation.

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.