Troubleshooting

Troubleshooting

Web interface does not open

docker compose ps
docker compose logs --tail=100 web
curl http://127.0.0.1:5000

Check firewall rules and confirm that port 5000:5000 is published.

Scanner cannot see the camera

ls -l /dev/video0
docker compose --profile scanner ps
docker compose logs --tail=100 scanner

Confirm the Compose device mapping and ensure no other process exclusively owns the camera.

NFC reader is detected by USB but remains unavailable

Confirm that the ACR122U or another PC/SC reader is visible:

lsusb
docker compose logs --tail=100 nfc

Release 1.3.8 removes stale pcscd PID and socket files automatically before starting PC/SC. On an older image, a one-time recovery is:

docker exec smart-drink-fridge-nfc \
  rm -f /run/pcscd/pcscd.comm /run/pcscd/pcscd.pid
docker restart smart-drink-fridge-nfc

The log should then contain PC/SC-NFC-Leser bereit.

Nextion still shows the Production Plant demo

Check the display profile and UART mapping:

docker compose --profile display ps
docker compose logs --tail=100 display
readlink -f /dev/serial0

On a Raspberry Pi 3, /dev/serial0 should normally resolve to /dev/ttyAMA0 after applying the PL011 configuration from Nextion display. Release 1.3.8 automatically stops the factory demo timer; no .tft flash is required.

PWA install option is missing

• Use the trusted https://...ts.net address
• Do not use a plain LAN HTTP address on the phone
• Open the page in Safari on iPhone/iPad or Chrome/Edge elsewhere
• Reload once and reopen the browser menu

See PWA and mobile installation.

Tailscale reports access denied

sudo tailscale set --operator="$USER"
./start.sh

For container mode:

docker logs smart-drink-fridge-tailscale

Tailscale is connected but HTTPS does not work

Check whether Tailscale Serve is configured:

docker exec smart-drink-fridge-tailscale tailscale status
docker exec smart-drink-fridge-tailscale tailscale serve status

If the second command reports No serve config, enable the proxy:

docker exec smart-drink-fridge-tailscale \
  tailscale serve --bg --yes --https=443 \
  http://127.0.0.1:5000

Confirm that the application itself is reachable from the Tailscale container:

docker exec smart-drink-fridge-tailscale \
  wget -qO- http://127.0.0.1:5000/ >/dev/null \
  && echo "Web service reachable"

Use the exact .ts.net address printed by tailscale serve status. A URL belonging to another machine in the same tailnet will open that other machine, not the fridge.

On first activation, certificate issuance can cause a short delay or one initial timeout. Wait a few seconds and retry. If it still fails, inspect:

docker logs --tail=100 smart-drink-fridge-tailscale

Look for got cert and listening on ...:443. See Tailscale and HTTPS for the full setup.

Update installation button is absent

The button is intentionally hidden unless every prerequisite in Updates is satisfied. A manual or locally tagged image does not qualify.

Forecast says there is not enough data

Forecasts require at least seven days between the first recorded booking and the current date. They use up to 30 days of consumption and include zero-consumption days.

Old mobile layout remains visible

Reload the page, fully close the installed PWA, and reopen it. If necessary, remove and reinstall the PWA after confirming that the browser shows the current release.