Control Server Installation

Requirements

Resources

• A minimum of 2GB memory (4GB+ recommended)
• A minimum of 20GB disk space

It's always good practice to make sure you can increase the resources of the control server. As the system grows and more users are interacting at the same time, resource usage will increase.

Operating Systems

The following operating systems are supported.

Operating System	x86_64	AArch64	Status	Notes
Debian 11 (Bullseye)	✅	❌	Fully Supported	VirtFusion is built and tested primarily on Debian based systems. This is our preferred choice of operating system.
Debian 12 (Bookworm)	✅	❌	Fully Supported	VirtFusion is built and tested primarily on Debian based systems. This is our preferred choice of operating system.
AlmaLinux 8 (RHEL 8)	✅	❌	Fully Supported
AlmaLinux 9 (RHEL 9)	✅	❌	Fully Supported
Rocky Linux 8 (RHEL 8)	✅	❌	Fully Supported
Rocky Linux 9 (RHEL 9)	✅	❌	Fully Supported
Ubuntu 22.04	✅	❌	Fully Supported	We don't recommend Ubuntu unless it supports something that Debian does not (drivers etc...).
Ubuntu 24.04	✅	❌	Fully Supported	We don't recommend Ubuntu unless it supports something that Debian does not (drivers etc...).

Important

VirtFusion should be the only application installed on the server. Installing any other applications (i.e. Pterodactyl, cPanel etc...) at control server level is not advised, and may invalidate any support contracts included with your VirtFusion license. It is permitted to install monitoring agents (Netdata, Hetrix Tools etc...).

VirtFusion does not include an uninstaller. If you make a mistake or decide not to use it, you must re-install the operating system to remove it.

Installation

Select your operating system.

Debian 11

Run the following commands as a root SSH user.

apt install curl -y
curl https://install.virtfusion.net/install-control-debian-11.sh | sh -s -- --verbose

Debian 12

Run the following commands as a root SSH user.

apt install curl -y
curl https://install.virtfusion.net/install-control-debian-12.sh | sh -s -- --verbose

RHEL 8

Run the following commands as a root SSH user.

dnf install curl -y
curl https://install.virtfusion.net/install-control-rhel-8.sh | sh -s -- --verbose

RHEL 9

Run the following commands as a root SSH user.

dnf install curl -y
curl https://install.virtfusion.net/install-control-rhel-9.sh | sh -s -- --verbose

Ubuntu 22.04/24.04

Run the following commands as a root SSH user.

22.04

apt install curl -y
curl https://install.virtfusion.net/install-control-ubuntu-22.04.sh | sh -s -- --verbose

24.04

apt install curl -y
curl https://install.virtfusion.net/install-control-ubuntu-24.04.sh | sh -s -- --verbose

Once the installer has completed the installation process, a URL and temporary username & password will be given.

+-------------+--------------------------------------+
|         URL | https://10.0.0.10                    |
|    Username | admin@admin.com                      |
|    Password | sQpfY1p1nhsxqXt                      |
+-------------+--------------------------------------+

SSL setup

A stock installation will generate a self-signed SSL certificate but this is probably not what you need. You can generate a signed set of certificates for your domain at no cost using a free SSL service.

acme.sh

caution

You must have an A record pointing to the control server IP in your DNS records before proceeding to setup a certificate.

Install acme.sh

wget -O -  https://get.acme.sh | sh
. ~/.bashrc

Generate a certificate (replace DOMAIN.COM with your own domain).

acme.sh --issue \
        --webroot /opt/virtfusion/nginx/acme \
        --ocsp-must-staple \
        --keylength 4096 \
        --server letsencrypt \
        -d DOMAIN.COM

Install the certificate (replace DOMAIN.COM with your own domain).

acme.sh --installcert \
        --keypath /opt/virtfusion/ssl/ssl.key \
        --fullchainpath /opt/virtfusion/ssl/ssl.crt \
        --reloadcmd "systemctl reload vf-nginx" \
        -d DOMAIN.COM

Activating a license

Login to VirtFusion with the new login details that were generated on installation.

You will be given the options to either generate an evaluation license or enter an existing license key.