Configuration

Configuration

Configuration is read from .env.

Variable	Purpose	Typical value
SECRET_KEY	Protects Flask sessions	Long random string
STORNO_PASSWORT	Password for cancelling scanner bookings	Private password
UPDATE_CHECKER_ENABLED	Enables release checks in Settings	true
DOCKER_UPDATE_ENABLED	Enables Docker update controls when the socket is mounted	false
PUSHOVER_USER	Optional Pushover user key	Empty when unused
PUSHOVER_TOKEN	Optional Pushover application token	Empty when unused
TAILSCALE_ENABLED	Starts/configures Tailscale through start.sh	false
TAILSCALE_AUTHKEY	Tailscale authentication key	Empty when unused
TAILSCALE_HOSTNAME	Name used in the tailnet	smart-drink-fridge
TAILSCALE_HTTPS	Enables Tailscale Serve HTTPS	true
NEXTION_PORT	Serial device for the optional Nextion display	/dev/serial0
NEXTION_BAUD	Initial baud rate used for display detection	9600
NEXTION_LANGUAGE	Display language: German, English, or French	de
NEXTION_USER_SECONDS	PIN-selected scanner-user lifetime	120

Generate a secret

For example:

openssl rand -hex 32

Never commit .env or share its contents in logs, issues, or screenshots.

Application settings

The web interface under Settings contains:

• Interface language
• Home Assistant URL, token, and shopping-list synchronization
• Visibility of products with zero stock
• Default currency for new prices
• Optional checkout home screen with user and drink tiles
• Backup frequency, time, day, retained count, and maximum age
• Software update status and manual update check
• Optional user accounts, roles, NFC cards, and scanner sign-in policy
• Optional Nextion content and inventory-page rotation
• Optional, password-confirmed Raspberry Pi reboot and power-off controls

User accounts and the stricter scanner policy are both disabled by default. See User accounts and NFC.

The Nextion environment variables select the serial connection and language. Which status sections and pages are visible is configured under Settings and is picked up by the running display service without flashing it again. See Nextion display.

See Updates before enabling Docker-based installation.