System requirements

Supported operating systems, memory, ports and network access for the VaultPanel server and the servers it manages.

Last updated

VaultPanel runs on one server (the panel's own server) and manages any number of servers through an agent. A fresh server is the best place to install it.

The panel's server

RequirementDetails
Operating systemUbuntu 22.04, 24.04 or 26.04 LTS, or Debian 12 or 13.
Init systemsystemd. Containers without systemd are not supported.
Package managerapt. The installer refuses systems without it.
AccessRun the installer as root.
PackagesAn up-to-date system with curl, wget and sudo installed. Run apt update && apt -y upgrade && apt -y install curl wget sudo before the installer (see Installation).
Memory2 GB or more is recommended. The installer warns below roughly 900 MB.

Other Ubuntu and Debian releases are not tested: the installer warns and continues. Any other Linux distribution is refused.

Ports

The installer refuses to start when one of these ports is already taken by something other than VaultPanel.

PortUsed byListens on
8090The panel (web interface and API, HTTPS). Change it with --port.All interfaces
8091Plain HTTP for this server's own use: the local agent, the panel domain's NGINX and the vaultpanel command. By default, the panel port + 1.127.0.0.1 only
3307The panel's own MariaDB, in Docker.127.0.0.1 only
6379The panel's own Redis, in Docker, with a password.127.0.0.1 only
3306The MariaDB for your websites and apps, when the installer sets one up. Checked only when it installs MariaDB.MariaDB's own setting

Your websites also need ports 80 and 443 once NGINX is installed, and Let's Encrypt must be able to reach port 80 to issue certificates. When UFW is active, the installer opens the panel's port in it.

What the installer sets up

SoftwareSource
Node.js 22NodeSource, installed system-wide at /usr/bin/node. A Node.js installed with nvm under /root is never used.
Docker with Docker ComposeDocker's install script from get.docker.com. An existing Docker, including the snap, is reused.
MariaDB for websites and appsThe system's packages when they carry the chosen version, otherwise MariaDB's repository (deb.mariadb.org). See the database for websites and apps.
The vaultpanel packageVaultPanel's signed package repository at installer.vaultpanel.net/apt. Nothing is downloaded from GitHub or built on the server.

The installer also looks up the server's public IPv4 address (from api.ipify.org, falling back to the server's own address) to build the panel's first address.

Database for websites and apps

The panel keeps its own database in Docker on port 3307. Separately, the installer can set up a MariaDB server on port 3306 for your websites and apps. Choose its version with DB_ENGINE:

SystemDB_ENGINE values (newest first)
Ubuntu 26.04 LTSMARIADB_12.3, MARIADB_11.8
Ubuntu 24.04 LTSMARIADB_12.3, MARIADB_11.4, MARIADB_10.11
Ubuntu 22.04 LTSMARIADB_11.4, MARIADB_10.11, MARIADB_10.6
Debian 13MARIADB_12.3, MARIADB_11.8
Debian 12MARIADB_12.3, MARIADB_11.4, MARIADB_10.11

DB_ENGINE=NONE installs no database server. MySQL 8.4 and 8.0 come in a later version; the installer refuses MYSQL_ values until then.

Other servers you connect

Servers you add to the panel run only the agent. They need:

  • 64-bit Linux with systemd, on x86-64 or arm64, run as root for the install,
  • curl,
  • outbound HTTPS to the panel's address. The agent connects out, so the server needs no inbound port for the panel.

One-click software installs (NGINX, PHP, Certbot, MariaDB and the rest) use apt, so they work on Ubuntu and Debian. On other systems, install the packages yourself and the agent picks them up within a few minutes.

Browsers

The panel serves HTTPS from its first start with a self-signed certificate, so your browser warns once. Check the certificate's SHA-256 fingerprint against the one the installer printed, then continue. For a certificate browsers trust, give the panel a domain.