Skip to main content

Updates

Every 6 hours Bunkerbox checks whether a newer version is available at https://bunkerbox.znbw.de (after an error again after 30 minutes). A new version shows up in the footer and under Updates.

Update from the interface​

Under Updates, Install update installs the newest version. The update runs as its own systemd unit bunkerbox-update outside the service: it downloads the package, verifies the SHA256 checksum, installs it to /appdata/bunkerbox/releases/<version>, switches over and restarts the service. If the new version does not become healthy within 60 seconds, the previous one is restored automatically.

While long running operations are active (for example creating a pool or updating an app), the update is refused. Shares and apps keep running during the restart.

Automatic updates​

With Install new versions automatically Bunkerbox installs new versions by itself as soon as nothing is running. A version whose installation failed is not retried automatically.

On the server​

sudo /appdata/bunkerbox/app/deploy/update.sh             # newest version
sudo /appdata/bunkerbox/app/deploy/update.sh --check     # check only (exit code 10 = update available)
sudo /appdata/bunkerbox/app/deploy/update.sh --rollback  # back to the previous version

--force skips the check for running operations. The update source is set with BUNKERBOX_UPDATE_URL, the check is disabled with BUNKERBOX_UPDATE_CHECK=0 in /appdata/bunkerbox/bunkerbox.env.