System requirements
Supported operating systems, memory, ports and network access for the VaultPanel server and the servers it manages.
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
| Requirement | Details |
|---|---|
| Operating system | Ubuntu 22.04, 24.04 or 26.04 LTS, or Debian 12 or 13. |
| Init system | systemd. Containers without systemd are not supported. |
| Package manager | apt. The installer refuses systems without it. |
| Access | Run the installer as root. |
| Packages | An 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). |
| Memory | 2 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.
| Port | Used by | Listens on |
|---|---|---|
8090 | The panel (web interface and API, HTTPS). Change it with --port. | All interfaces |
8091 | Plain 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 |
3307 | The panel's own MariaDB, in Docker. | 127.0.0.1 only |
6379 | The panel's own Redis, in Docker, with a password. | 127.0.0.1 only |
3306 | The 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
| Software | Source |
|---|---|
| Node.js 22 | NodeSource, installed system-wide at /usr/bin/node. A Node.js installed with nvm under /root is never used. |
| Docker with Docker Compose | Docker's install script from get.docker.com. An existing Docker, including the snap, is reused. |
| MariaDB for websites and apps | The 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 package | VaultPanel'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:
| System | DB_ENGINE values (newest first) |
|---|---|
| Ubuntu 26.04 LTS | MARIADB_12.3, MARIADB_11.8 |
| Ubuntu 24.04 LTS | MARIADB_12.3, MARIADB_11.4, MARIADB_10.11 |
| Ubuntu 22.04 LTS | MARIADB_11.4, MARIADB_10.11, MARIADB_10.6 |
| Debian 13 | MARIADB_12.3, MARIADB_11.8 |
| Debian 12 | MARIADB_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.