Updates

Updates

Update information appears only under Settings → Software update. Other application pages do not contact GitHub.

Check manually

Select Check for updates now to bypass the six-hour result cache and request the latest GitHub release immediately.

Standard Docker update

The safest update method is:

docker compose pull
docker compose up -d

Review the release notes first.

Optional one-click Docker update

One-click updates are disabled in the normal Compose configuration. Enable the security-sensitive override explicitly:

docker compose \
  -f docker-compose.yml \
  -f docker-compose.updates.yml \
  up -d

The install button appears only when:

• A newer GitHub release exists
• The app is running in Docker
• DOCKER_UPDATE_ENABLED=true
• /var/run/docker.sock is mounted
• The container uses ghcr.io/derrobin99/smart-drink-fridge

The updater starts Watchtower for a single run, replaces only the web container, preserves its configuration and volumes, then removes the helper.

The application identifies the managed web container by its stable Compose container name. This remains valid after Watchtower replaces the container; Docker's changing internal hostname is not used as the primary identifier.

Docker socket access is effectively root access to the Docker host. Use it only on a trusted private network. Never expose this application directly to the public internet.

The same override also makes the optional Raspberry Pi reboot and power-off controls technically possible. Those buttons remain disabled until separately enabled under Settings and always require password confirmation.

To disable one-click updates, recreate the service using only:

docker compose up -d