Guida · Per gli amministratori

Installazione

Scaricare e installare

Sul server del pannello, come 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.tuodominio.it

koavm-latest è sempre l'ultima versione stabile (le versioni sono elencate in Novità; ognuna resta scaricabile come koavm-VERSIONE-linux-amd64.gz). Con il nome di dominio il pannello chiede da solo il certificato HTTPS a Let's Encrypt: il dominio deve già puntare al server e le porte 80 e 443 devono essere aperte. Senza dominio il pannello ascolta in HTTP sulla porta 8080: va bene solo per le prove.

Lo script:

crea l'utente di sistema koavm e la cartella dei dati /var/lib/koavm;
installa il binario in /usr/local/bin/koavm (tiene la versione precedente in koavm.prev);
crea il servizio koavm (con permessi ristretti: scrive solo nella sua cartella) e il servizio koavm-update, che installa gli aggiornamenti chiesti dal pannello.

Rilanciarlo con un binario nuovo aggiorna il pannello senza toccare i dati.

Il primo amministratore

sudo -u koavm koavm user add --data /var/lib/koavm --email tu@esempio.it --name "Il tuo nome" --role admin

Il comando stampa la password. Entra su https://vm.tuodominio.it/admin e cambiala da Account › Cambia password.

Dove sono le cose

Cosa	Dove
Binario	`/usr/local/bin/koavm` (precedente: `koavm.prev`)
Dati e database	`/var/lib/koavm` (`koavm.db`)
Opzioni di avvio	`/etc/default/koavm` (`KOAVM_ARGS=--domain vm.tuodominio.it`)
Registro	`journalctl -u koavm`
Copie del database prima degli aggiornamenti	`/var/lib/koavm/koavm-prima-VERSIONE.db`

Fai una copia di /var/lib/koavm insieme ai backup del server: contiene il database, il certificato con cui il pannello parla ai nodi e la chiave SSH del pannello.