Skip to content

Update the appliance to the signed version offered under Updates.

  • An administrator sign-in to the appliance.
  • A backup you have downloaded from the appliance.
  1. Open Appliance › Maintenance › Updates and click Check for updates.
  2. Read Release note and check that the page says the version is signed.
  3. Click Update now, then Confirm update. The update starts within a minute.
  4. Wait for the web interface to restart, then open the page again.

Last update shows Completed and Installed version shows the chosen version. Certificates on servers keep working during the update.

  • The version is not signed yet and cannot be installed → wait and click Check for updates later.
  • The appliance has no host controller → follow the instructions on the Docker page to add it or update from the host.
  • Aborted, the version did not change → read Update log and follow The update fails.
  • The web interface does not respond → use the console as described below.

On the same page, save your choices for:

SwitchEffect
Appliance updatesInstalls signed appliance versions.
ModulesDownloads and updates modules. Downloading does not activate them.
Integrations and service agentsDownloads integrations and the service agent’s installation files.
Automatic agent approvalApproves service agents using a one-time key or code.

An install code from Servers › Add server approves the server regardless of the switch. Without a code, the server waits for an administrator. Downloads cannot be switched off while automatic approval of integration versions is enabled under Appliance › Integrations › Automatic.

Renewal always runs. Each installation plan’s Install on renewal decides whether the certificate is also installed, see Renewal.

The Service agent updates card offers Automatic (recommended), Manual and Off. Only an Owner can change the choice. The server checks the signature and reinstalls the version it was running if the chosen version does not check in within 10 minutes. See Keep service agents up to date.

On the virtual appliance, choose 6 Update to the latest version in the console menu. Wait for WORKED. or FAILED (exit N). On failure, choose 4 View logs, then 2 The controller: updates, restarts, signature checks.

If the software cannot start, choose 9 Danger zone and 6 Reinstall the appliance software (data kept). This reinstalls the running version and keeps the data. Docker has no console menu.

Host updates covers the virtual appliance’s console, login, SSH and controller. The default Security fixes only, automatically (default) leaves other fixes waiting for approval. Automatically in the service window applies fixes during the window; Manual only requires approval for all fixes.

Ubuntu downloads security updates automatically. A required restart takes place at 03:00. On a Docker host, you manage host updates yourself.