Documentation

Updates

In production, update through Admin → Settings → Updates, or the flutter-update helper. That pulls the latest git, runs npm ci, rebuilds the panel, and restarts services.

From the panel

Admin → Settings → Updates. The page shows the installed version, the latest commit on the tracked ref, and a live log while an update runs. Only one update job at a time.

From the shell

bash

sudo /usr/local/sbin/flutter-update
sudo /usr/local/sbin/flutter-restart
cd /opt/flutter && docker compose ps

flutter-update runs scripts/self-update.mjs as the flutter user with /opt/flutter/.env loaded. It refuses to start if an update unit is already active.

What is preserved

/opt/flutter/.env — secrets and URLs
Daemon config.json and /var/lib/flutter game data
MongoDB and Redis volumes

After a deploy

Hard-refresh the browser if the login page fails to load JS chunks. Next.js filenames change between builds; a stale tab will 404 hashed assets until you reload.