Skip to main content

Management Server Installation

System Requirements​

  • 4GB+ Memory Recommended
  • 20GB+ Storage Recommended

Installation Steps​

apt install -y wget curl
curl -s https://packages.hypervisor.io/master/install.debian.sh | bash

Once installation process has completed, you can reach the management UI on port 443 of your public IP.

Admin User​

To generate the first admin user, please run the following command

cd /opt/hypervisor
php artisan admin:create-user

After entering all the relevant details, user credentials should be on your screen.

SSL Setup​

info

Please ensure you have a valid A record pointing to your management server.

Let's download the acme.sh script to the server

wget https://github.com/acmesh-official/acme.sh/blob/master/acme.sh -O /opt/hypervisor/storage/acme.sh
chmod + /opt/hypervisor/storage/acme.sh
cd /opt/hypervisor/storage
./acme.sh --register-account [email protected] --home /etc/nginx/ssl

Let's issue a certificate for the domain that is pointed to the server

./acme.sh --issue \
        -w /opt/hypervisor/public \
        --home /etc/nginx/ssl
        -d DOMAIN.COM

Now since acme has generated the certificate, it will store them in /etc/nginx/ssl

We will proceed with installing the certificate in the following location and restart nginx while doing the same

./acme.sh --installcert --home /etc/nginx/ssl \
        --keypath /opt/hypervisor/storage/ssl/hypervisor.key \
        --fullchainpath /opt/hypervisor/storage/ssl/hypervisor.crt \
        --reloadcmd "systemctl restart nginx" \
        -d DOMAIN.com

Setup a cron for automatic renewal to run daily, to ensure we don't hit any API limits, this will ensure you don't have to renew the certificate manually

echo "root 0 0 * * * /opt/hypervisor/storage/acme.sh --cron --home /etc/nginx/ssl\n\n" > /etc/cron.d/acme.cron