Getting started

Installation

Install NexoVirt on a fresh Ubuntu 22.04 or 24.04 server with a single command.

Install

Run this on a clean Ubuntu server as root, with your license key in the NEXOVIRT_LICENSE variable:

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

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:

url
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:

bash
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):

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

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.

This documentation describes NexoVirt as it stands today and grows with it. Something missing? Get started free.
On this page