How to update the control panel to a new version

For server administrators · Updated 2026-10-29

On this page
  1. Steps
  2. What happens during the update
  3. Good to know
  4. Common questions

New versions of the control panel bring new features and fixes. You install them from the Updates page. Websites, email and databases stay online during the update.

Steps

  1. Log in to the administrator panel (https://<server>:2087).
  2. Open Updates in the menu (section Server). The top shows the Installed version and when the server last checked.
  3. Click Check for updates to look at once.
  4. If a newer version exists, the card Version … is available lists what changed in each version since yours.
  5. Click Update to … and confirm.
  6. The page shows Update to … in progress and refreshes by itself every few seconds. Open Update log to follow each step.
  7. When it is finished, the card shows Last update: with the new version and the state done.

When you already have the newest version, the page says You have the latest version.

What happens during the update

  1. The new release is downloaded over HTTPS and its checksum is verified. A damaged or altered download stops the update before anything changes.
  2. A snapshot of the current version is saved on the server: the panel's code and the panel's database, in /root/panel-snapshots/. The last three snapshots are kept.
  3. The new version is installed. The panel may be unavailable for about a minute while its services restart.
  4. If the installation fails, the previous version is put back automatically. See update failed and rollback.

Good to know

  • Fix releases install themselves at night (for example 0.30.0 → 0.30.1), unless you turn this off. Versions with new features (for example 0.31) are always your choice. See automatic fix releases.
  • The dashboard shows a notice Version … is available. when there is a new version.
  • The Changelog at the bottom of the Updates page lists the changes of every installed version.
  • Only one update runs at a time.
  • The log of the last update is kept in /var/log/panel-update.log on the server.
  • The same page also installs operating system updates; those are separate from panel updates.

Common questions

Do websites go offline during an update?

No. Websites, email and databases keep running. Only the panel itself may not answer for about a minute at the end.

Can I skip a version?

Yes. The update always installs the newest version, with all the changes of the versions in between.

Why does the page show an error when I check for updates?

The server could not reach the update server. Check that the server has internet access and that outgoing HTTPS is allowed, then click Check for updates again.

Was this article helpful?

Still stuck?

Ask the AI about your exact situation — it answers from this knowledge base — or contact us.