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