Keep Quantix up to date

Quantix updates QvDC and your QHCI hosts separately. Every update is signed by Quantix, and QvDC and hosts verify that signature, however the update arrived.

There are two ways to get updates:

• Online — QvDC and hosts download updates from https://updates.quantixkvm.com. Your firewall needs to allow outbound HTTPS (TCP 443) to *.quantixkvm.com.
• Offline — download an update bundle (.qxbundle) from the customer portal on a machine with internet access, and upload it to your QvDC or to a standalone host.

Prerequisites

• A deployment token for online updates. Create one in the customer portal under Deployments. It is shown only once — copy it straight into the update settings below. After you save it, Quantix never shows it again; the settings only say whether a token is set.
• An administrator account on QvDC (or the host's admin account for a standalone host).
• A maintenance window for host updates that replace the system image: the host reboots, so move or shut down its VMs first.

Configure online updates in QvDC

1. Go to Admin Panel → System → Updates.
2. Under Update Configuration (each setting saves on its own):
   • Update Channel — keep Stable. Beta and Dev are for testing; Quantix's public update server offers Stable only.
   • Update Server — enter https://updates.quantixkvm.com and click Save.
   • Deployment Token — paste your deployment token and click Save. The badge changes from Not set to Set. To replace the token, paste the new one and click Save; to remove it from QvDC, click Clear (hosts keep the token they have until you save a new one).
   • Auto Check — check for updates periodically;
   • Auto Apply — apply updates that need no reboot automatically.
3. QvDC passes the update server and token on to the hosts it manages — when you save them, and whenever a host joins or reconnects — so you do not need to enter them on each host. If a host has not received them yet, its card under QHCI Host Updates says Update settings not delivered to this host yet; QvDC tries again when the host reconnects.

Update QvDC

1. In Admin Panel → System → Updates, under Quantix-vDC Updates, click Check.
2. If the badge shows Update available, review What's included and the release notes, then click Apply Update.
3. The dashboard shows the update's progress. When it shows Update complete, click Reload now.

Expected result: Installed shows the new version and the badge reads Up to date. If an update fails, QvDC rolls it back and shows Update failed with Retry update.

Update hosts from QvDC

1. Under QHCI Host Updates, click Check All Hosts. Only hosts in the Ready state are listed.
2. For each host with an update, click Update.
3. If the update replaces the host's system image, the host reboots into the new version. Quantix keeps the previous version on the second system partition, so a host that fails to boot the new version returns to the old one.

Expected result: each host's card shows it is up to date.

Update a standalone host

On a host that is not managed by QvDC, use its Host UI:

1. Go to Admin Panel → Updates.
2. Under Update settings, enter the Update server URL (https://updates.quantixkvm.com) and paste your token into Deployment token, then click Save settings. The token then shows set. To remove it, click Clear token. Until an update server is set, the host cannot check for updates.
3. Choose the stable channel.
4. Click Check. The host does not check on a schedule — only when you press Check.
5. If the status is Update available, click Update host. For an update that replaces the system image, confirm Download and install system image, then Reboot host now when prompted. Rebooting interrupts the VMs running on the host.

Expected result: the status shows Up to date.

Offline updates with an update bundle

Use a bundle when your hosts and QvDC have no internet access. A bundle is a single file holding one signed release of Quantix-OS (for hosts) or Quantix-vDC (for QvDC itself).

1. On a computer with internet access, sign in to the customer portal, open Downloads, and download the update bundle for the product and version you need (quantix-os-<version>.qxbundle for hosts, quantix-vdc-<version>.qxbundle for QvDC). Note the published SHA-256 checksum and compare it with the downloaded file.
2. Move the bundle into your network.

A bundle is checked before anything is installed: its signature must be a valid Quantix signature and every file in it must match the signed contents. A bundle that fails either check is always refused and deleted, and the system you uploaded it to is left exactly as it was. Bundles have no other way to prove where they came from, so this check cannot be relaxed.

With QvDC:

3. Go to Admin Panel → System → Updates. Under Offline Update Bundles, click Import update bundle and choose the file (up to 4 GiB). The page shows the upload's progress, then lists the imported release with Signature verified. QvDC keeps one bundle for each product: importing another bundle for the same product replaces the one it has.
4. To update QvDC from a Quantix-vDC bundle, click Install on QvDC next to it. The update then runs and reports its progress exactly as in Update QvDC.
5. To update hosts from a Quantix-OS bundle, click Apply to hosts next to it and confirm. Every host in the Ready state downloads the update from your QvDC, checks the signature itself, and installs it; follow each host under QHCI Host Updates. Hosts reach QvDC for this over HTTPS (TCP 443) or, on older QvDC installations, on the QvDC API port (TCP 8080) — allow that traffic from your hosts to QvDC.
6. A host whose update includes a new system image shows that it needs a reboot. Move or shut down its VMs, then open that host's Host UI, go to Admin Panel → Updates, and click Reboot host now. (QvDC's Restart host… checks the host against an update server first, which an offline host cannot reach.)

A host can take an offline update only if its installed Quantix-OS already supports offline updates. QvDC checks each host before it starts and, for a host that does not, reports predates offline updates and leaves it untouched. Update such a host once from an update server, or reinstall it from a current Quantix-OS installer, first.

On a standalone host:

3. In the Host UI, go to Admin Panel → Updates. Under Offline update, click Upload bundle and choose a Quantix-OS bundle (up to 4 GiB).
4. Confirm Upload and install. The host uploads the bundle, checks the signature and every file, and installs the update; the progress window shows each step. If the update includes a new system image, click Reboot host now when prompted — rebooting interrupts the VMs running on the host.

Expected result: QvDC or the host shows the new version, as after an online update.

If an update fails

Symptom	What to do
Check finds nothing and the host shows Not checked	Set the update server under Update settings, then check again.
Download fails or times out	Check that outbound HTTPS to *.quantixkvm.com is allowed, and that the deployment token has not been revoked in the portal.
An update is refused because of its signature, or shows Signature not verified	The update was damaged or did not come from Quantix. Download it again from the portal. Do not install it.
Update bundle not imported or Update bundle not accepted	The message says why: the file is not a Quantix bundle, it is damaged, it is not signed by Quantix, or it is over 4 GiB. Download the bundle again and compare its SHA-256 checksum with the one in the portal. Nothing was installed.
Apply to hosts starts, but a host fails to download the update	Check that the host can reach QvDC on TCP 443, or on TCP 8080 for older QvDC installations.
Download fails with an authorization error	Check that Deployment Token (QvDC) or Deployment token (host) shows Set. If it does, the token may have been revoked: create a new one in the portal and save it.
Components missing on a host	Click Check again, then Update host to complete the update.
Update failed	Use Retry update. If it fails again, open a ticket in the customer portal and attach the message shown under Technical details.