MuPiBox Documentation MuPiBox NG

Updates

Find MuPiBox updates and install them with one click, choose the update channel, go back to older versions and understand what happens during an update.

Under Maintenance → Updates you keep the box up to date. The box already checks in the background whether there is an update when the admin interface is opened.

Installing an update

The top of the page always shows the current state:

DisplayMeaning
Checking for updates …the box is asking the update server.
Update available: <version>install it with Update now. The release notes are right below.
MuPiBox is up to dateno newer update in the chosen channel.
Updating …progress with stage and percent.
Update failedthe cause is shown below; "Check for updates" tries again.

When an update is available, the left sidebar also shows an orange "New update" notice under the quick links.

What happens during an update

  1. The box downloads the release from releases.mupibox.de and verifies signature and checksum.
  2. It saves the database and configuration.
  3. It activates the new version and restarts once.
  4. After the start the new version confirms that it runs. If that fails, the box returns to the previous version automatically on the next start.
  5. New system dependencies are installed.

The history of every update is under Logs (source "Updates").

Update channel and advanced

ChannelFor
Auto (default)Stable → Alpha → Test → Development – the most mature published release
Stablestable versions only
Alphaearly versions with new features
Testtest versions for testers
Developmentdevelopment builds, may contain bugs

Only change the manifest source for development or testing.

Version history

Lists all published versions with release notes. From here you can also switch back to an older version; a configuration backup is created automatically first.