Virtualizor

Update Virtualizor and maintain your VPS host nodes

Update the Virtualizor panel and its nodes, apply OS and kernel updates safely, plan maintenance windows, notify customers and check that virtual machines come back.

AdvancedVirtualizor admin2 min read

A VPS platform has two layers to keep current: the Virtualizor panel software and the host operating system with its kernel, QEMU and libvirt. Panel updates are usually quick and invisible to customers; host updates that need a reboot affect every VPS on the node and must be planned.

Before you start

  • Root access to the master and all slave nodes.
  • Recent backups of customer VPS; see backup servers and plans.
  • Out-of-band access (IPMI/iDRAC) to each node in case a reboot fails.

Update the Virtualizor panel

  1. In the admin panel go to Configuration → Updates (or Update Virtualizor).
  2. Choose the update channel – Stable for production.
  3. Enable Auto Update for panel updates if you prefer, or click Update Now to install the latest version.
  4. Update the master first, then each slave. Keep all servers on the same version.

Panel updates do not restart virtual machines. Read the release notes for changed defaults or new requirements.

Update the host OS

On each node, install security updates regularly:

dnf -y update

(or apt update && apt -y upgrade on Ubuntu). Updates to QEMU take effect only when each VM is restarted; kernel updates need a node reboot.

Plan a node reboot

  1. Schedule a maintenance window at a quiet time and give customers notice – at least a few days for planned work.
  2. Notify customers on that node. With WHMCS, use the Mass Mail Tool filtered by server and post a Network Issue; see mass mail and reports.
  3. Optionally migrate important VPS to another node beforehand; see add slave servers.
  4. Reboot the node. Virtualizor starts VPS that were running before, if Start VPS on boot is enabled in the master settings.
  5. Check Virtual Servers → List VPS for servers that did not start and start them manually.

Routine maintenance checklist

  • Watch free space in the LVM volume group and on backup servers.
  • Review RAM overcommit and CPU load per node in the dashboard.
  • Remove end-of-life OS templates and add new releases; see OS templates.
  • Check disk health with smartctl and RAID status.
  • Renew the panel SSL certificate (automatic with Let's Encrypt) and the Virtualizor licence.
  • Review admin logins and API keys.

Troubleshooting

  • Panel update fails: check disk space and connectivity to Virtualizor's update servers; rerun the update.
  • Node does not come back after reboot: use IPMI to view the console; common causes are network bridge configuration and old kernels.
  • VPS stay offline after reboot: autostart disabled or storage not mounted; start them and fix the setting.
  • Master and slave out of sync: update both to the same version.

Next steps

Was this guide helpful?

Still stuck?

Ask MdmHost AI for a quick answer, or open a ticket and our team will take a look. We are here 24/7.