How to update the control panel to a new version
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
- Log in to the administrator panel (
https://<server>:2087). - Open Updates in the menu (section Server). The top shows the Installed version and when the server last checked.
- Click Check for updates to look at once.
- If a newer version exists, the card Version … is available lists what changed in each version since yours.
- Click Update to … and confirm.
- The page shows Update to … in progress and refreshes by itself every few seconds. Open Update log to follow each step.
- 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
- The new release is downloaded over HTTPS and its checksum is verified. A damaged or altered download stops the update before anything changes.
- 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. - The new version is installed. The panel may be unavailable for about a minute while its services restart.
- 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.logon 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.
Thank you — this helps us improve the article.
Still stuck?
Ask the AI about your exact situation — it answers from this knowledge base — or contact us.
Related articles
- Automatic fix releases: how night-time panel updates work
Fix releases of your version line install themselves around 3 a.m. Learn what is updated automatically, what is not, and how to turn it off.
- Panel update failed: automatic rollback and snapshots
What happens when a control panel update fails, how the previous version is put back automatically, and how to restore a snapshot by hand.
- How to install operating system updates and security fixes
See which system packages wait for an update, install only the security fixes or everything, and restart the server when a new kernel needs it.
- The admin dashboard explained: what each number means
What the administrator dashboard shows: accounts, domains, tasks, server load, memory, disk, websites that are down and new versions.