Installation

Download and install

On the panel server, as root:

curl -fsSL https://koavm.com/releases/koavm-latest-linux-amd64.gz | gunzip > koavm
curl -fsSLO https://koavm.com/releases/install.sh
sudo bash install.sh ./koavm vm.yourdomain.com

koavm-latest is always the latest stable version (versions are listed in What's new; each one stays downloadable as koavm-VERSION-linux-amd64.gz). With the domain name the panel requests its HTTPS certificate from Let's Encrypt on its own: the domain must already point to the server and ports 80 and 443 must be open. Without a domain the panel listens over HTTP on port 8080: only for testing.

The script:

• creates the koavm system user and the data folder /var/lib/koavm;
• installs the binary in /usr/local/bin/koavm (keeping the previous version as koavm.prev);
• creates the koavm service (restricted: it only writes to its own folder) and the koavm-update service, which installs the updates requested from the panel.

Running it again with a new binary updates the panel without touching the data.

The first administrator

sudo -u koavm koavm user add --data /var/lib/koavm --email you@example.com --name "Your name" --role admin

The command prints the password. Sign in at https://vm.yourdomain.com/admin and change it from Account › Change password.

Where things are