Installation

Install NexoVirt on a fresh Ubuntu 22.04 or 24.04 server with a single command. No license key needed to get started.

Install (no license key needed)

Run this on a clean Ubuntu server as root:

curl -fsSL https://release.nexovirt.com/install | bash

With no NEXOVIRT_LICENSE set, the installer auto-provisions a free, unclaimed Community Edition license for you behind the scenes, no account, no key to copy first. Community Edition is keyless and free: self-hosted, every feature, up to 2 Proxmox nodes.

Already have a license key (Enterprise, or a Community key from a previous install)? Pass it inline to use that key instead of provisioning a new one:

curl -fsSL https://release.nexovirt.com/install | NEXOVIRT_LICENSE=<key> bash

Claim your install

A keyless install runs Community Edition immediately, but its license starts unclaimed (not yet tied to any account). Claim it whenever you like:

Log in to the panel and open Settings → Edition & license. While unclaimed, a “Claim this install” card shows your license key and a link to the claim page.
Follow the link to nexovirt.com/account/licenses/claim (the NexoVirt customer portal) and sign in or register.
Paste the license key there. The portal claims any unclaimed license by key and ties it to your account.

Claiming costs nothing and doesn’t change what the install can do; it just lets you manage the license (renewals, upgrades, support) from your account. Later, upgrading that license to Enterprise lifts the 2-node cap and unlocks white-label branding and the reseller tier, no reinstall required.

What the installer does

The script provisions a complete, ready-to-run panel on a clean box:

Detects the OS (Ubuntu 22.04 / 24.04) and installs PHP plus the required extensions.
Installs and configures the web server and database, and creates a dedicated system user.
Downloads the licensed release, runs database migrations, and seeds the first admin account.
Starts the background workers (metrics, inventory, provisioning, alerting, mail, console proxy).
Serves the panel over HTTP on the server’s IP, ready to log in immediately.

Re-running the same command on an existing install performs an in-place update instead of a fresh install (see Updating).

First access (IP-only)

The first install is intentionally IP-only over HTTP: there is no domain or certificate yet. Once it finishes, open the panel in your browser at your server’s address and sign in with the admin credentials the installer printed:

http://<your-server-ip>/

Change the seeded admin password right after your first login.

Configure a domain (later, in the panel)

When you are ready to put NexoVirt behind a hostname with TLS, do it from inside the panel under Settings → Domain: set your FQDN and NexoVirt rewrites its base URL and provisions the certificate. IP access keeps working alongside the domain.

There is also a CLI equivalent if you prefer the shell:

sudo /var/www/nexovirt/deploy/install.sh --set-hostname panel.example.com

Updating

To update an existing install to the latest release, run the same installer command again: it detects the existing install and updates in place (pulling the new release and running any pending database migrations):

curl -fsSL https://release.nexovirt.com/install | bash

An existing install already has a license on file (claimed or not), so NEXOVIRT_LICENSE is not needed on update either.

Uninstall

NexoVirt installs into /var/www/nexovirt with a dedicated system user and a few background services. To remove it, stop and disable the NexoVirt services and remove the install directory and its system user. Because NexoVirt only talks to your Proxmox hosts over the API and the agent, removing the panel leaves your Proxmox nodes and guests untouched.