Skip to main content

Deploy and register XOA

The Xen Orchestra Appliance (XOA) is a turnkey virtual machine with Xen Orchestra pre-installed, ready to manage your XCP-ng hosts and pools. It is also the only version covered by Vates professional support.

Deploy the appliance​

The easiest way is the web deploy form at vates.tech/deploy: log in to your account, point it at your host, and it imports the XOA VM for you. All the deploy code runs in your browser, and nothing is sent to Vates servers.

Alternatively, run this from your XCP-ng host:

root@xcp-ng-host — deploy XOA
# bash -c "$(wget --no-verbose -O- https://xoa.io/deploy)"

It simply imports the XOA VM into your default storage repository, without modifying anything on the host. You will be asked for the IP configuration (DHCP by default, or a static address).

By default the appliance uses 2 vCPUs, 2 GiB of RAM and 20 GiB of disk, which is enough for most infrastructures.

First login​

Open the appliance's IP address in your browser. Default web UI credentials are admin@admin.net / admin. Change them right away. If you don't know the IP, check your DHCP leases for an xoa entry or run xe vm-list params=name-label,networks | grep -A 1 XOA on the host.

Register your appliance​

Registration is the first thing to do: updates and trials are only available on a registered XOA. Go to the Updates view in the main menu and sign in with the email and password of your Vates account. Since new appliance images are not generated for every release, you will very likely need to update Xen Orchestra right after deployment, which requires registration.

Full details: XOA installation and updater & registration.

Keep it up to date​

Xen Orchestra follows a monthly release cycle, and updates are applied in a few clicks from the Updates view. Two release channels are available:

  • Stable: thoroughly tested, recommended for production.
  • Latest: the newest features each month. Xen Orchestra 6 is now the default interface on this channel, with no manual configuration required.

Next step: activate your trial to test every feature of the stack.