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
• Backup actions
• Software update status and manual update check
• Optional user accounts, roles, NFC cards, and scanner sign-in policy

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

The Nextion variables are used only when the optional display Compose profile is active. See Nextion display.

See Updates before enabling Docker-based installation.