Install QvDC

Quantix-vDC (QvDC) is the control plane: one dashboard for all your hosts, virtual machines, networks and storage. It runs as an appliance — usually a VM on one of your QHCI hosts.

Choose how to deploy it

Method	Use it when
Deploy QvDC from a host's Host UI	You already have a QHCI host. The simplest option.
OVA	You deploy it on another hypervisor that imports OVA appliances.
ISO installer	You install it on a dedicated physical server or an empty VM.

Download the appliance from the customer portal.

Sizing

Size	vCPU	Memory	Disk	Scale
Small	2	4 GB	40 GB	up to 10 hosts, 100 VMs
Medium (recommended)	4	8 GB	100 GB	up to 50 hosts, 500 VMs
Large	8	16 GB	200 GB	up to 200 hosts, 2000 VMs

Prerequisites

• A static IP address for the appliance, and ideally a DNS name for it (for example vdc.example.com). Passkey sign-in needs a DNS name: browsers do not allow passkeys on a bare IP address.
• Network reachability from the appliance to every host on TCP 8443 and 9443, and from your browser to the appliance on TCP 443.

Option A: deploy from a QHCI host

Download the QvDC QCOW2 (or OVA) appliance image first.

1. Sign in to the host's Host UI (https://<host-address>:8443/) as admin.
2. In the Welcome to Quantix-OS wizard choose Deploy Quantix-vDC on this host, or open Deploy QvDC from the sidebar.
3. Upload Image — choose the Destination Storage Pool and upload the appliance image (or pick one under Previously Imported Images).
4. Configure VM — set the VM Name, CPU Cores, Memory (MiB) and disk size (Small, Medium, Large or a custom size; the defaults are 4 cores, 8 GiB and 40 GB). Choose DHCP or Static IP (IP Address (CIDR), Gateway, DNS Servers), and leave VM Network Connection on Auto-detect (recommended) unless you need a specific bridge.
5. Deploy — the host creates and boots the appliance. In QvDC Initial Setup, enter the dashboard Admin Credentials (Username, Email, Password); the database and certificates are prepared automatically.
6. Connect Host — the host adds itself to the new QvDC. When the wizard shows Complete, open the appliance address it shows and continue with First sign-in.

Option B: import the OVA

1. Import the .ova file into your hypervisor.
2. Choose a deployment size: Small (2 vCPU, 4 GB RAM), Medium (4 vCPU, 8 GB RAM) (default) or Large (8 vCPU, 16 GB RAM).
3. Fill in the appliance properties: Hostname (default quantix-vdc), IP Address (leave empty for DHCP), Subnet Mask, Default Gateway, DNS Server(s) and NTP Server (default pool.ntp.org).
4. Power on the appliance and continue with First sign-in.

Option C: install from the ISO

The ISO installer has the same requirements as a QHCI host: a 64-bit CPU with hardware virtualization enabled, at least 4 GiB of memory, a disk of at least 10.5 GiB that is erased, and UEFI boot.

1. Boot the ISO and press Enter on the Welcome screen to scan the hardware.
2. Select the target disk. A disk that already holds data must be confirmed by typing ERASE.
3. Hostname. Enter the hostname (default quantix-vdc) and the public dns name users will type in their browser, for example vdc.example.com. The appliance's certificate is issued for this name. Without it, the certificate names only the IP address and passkeys will not work.
4. Management network. Choose DHCP or a static address — enter the address with its prefix length, for example 192.0.2.30/24, plus gateway and DNS.
5. Root password (at least 6 characters) for the appliance console and SSH.
6. Web admin account. Enter the dashboard administrator's username (default admin), an optional email, and a password of at least 8 characters.
7. Review the Installation summary and press Enter to install. When the installer shows the dashboard address, remove the install media and reboot.

First sign-in

1. Open https://<appliance-address>/ in a browser. Plain HTTP on port 80 redirects to HTTPS. The appliance starts with a self-signed certificate, so the browser warns you once.
2. If the browser shows Initial Setup, complete it:
   • Admin Account — Username, optional Email, Password (at least 8 characters) and Confirm Password, then Create Admin & Continue;
   • Database and TLS Certificates run by themselves (use Retry if one fails);
   • Finalize — click Complete Setup.
3. Sign in with the administrator account.
4. Set your organization name under Admin Panel → System → Organization.

Expected result

The dashboard opens and shows an empty inventory. Next, activate your licence and add your hosts.

The appliance console

The appliance's own console (its VM console or screen) shows a text menu for first aid: System Information, Configure Network (Ethernet), Configure SSH, Manage Services, Change Root Password, Troubleshooting and Power Options. Use Configure Network if the appliance's address has to change and the dashboard cannot be reached.