Installazione

$ curl -fsSL https://get.koapanel.app | sudo bash

Lo script controlla il sistema, scarica il pannello dal canale ufficiale e ne verifica la firma digitale (ed25519) e l'impronta SHA-256 prima di installare. Se qualcosa non torna, si ferma senza toccare il server.

Opzioni: KOAPANEL_EMAIL=tu@dominio.it (email per Let's Encrypt), KOAPANEL_MAIL=1 (attiva subito la posta), KOAPANEL_DOWNLOAD_ONLY=1 (scarica e verifica soltanto). Esempio: curl -fsSL https://get.koapanel.app | sudo KOAPANEL_EMAIL=tu@dominio.it bash

Con i parametri scegli tutto già dal comando: curl -fsSL https://get.koapanel.app | sudo bash -s -- --hostname pannello.miodominio.it --email tu@miodominio.it --license CODICE --koabilling. --hostname è il nome del pannello: il certificato Let's Encrypt arriva in automatico se il nome punta già al server e la porta 80 è aperta. --license attiva la licenza. --koabilling mostra alla fine indirizzo e chiave API da incollare in KoaBilling; senza licenza, la chiave funziona dopo aver collegato l'account.

Preferisci leggere lo script prima? Scaricalo, controllalo, poi esegui sudo bash install.sh.

Requisiti

• Un server nuovo (VPS o dedicato) con Ubuntu 24.04 o 26.04 LTS, AlmaLinux 9 o Rocky Linux 9 (SELinux può restare attivo), x86_64 o arm64, con accesso root. Non installarlo su un server che ospita già siti o un altro pannello: lo script se ne accorge e si ferma.
• Almeno 2 GB di RAM consigliati: posta e antivirus si adattano alla memoria disponibile.
• Porte 80 e 443 raggiungibili per i siti e i certificati; il pannello usa la porta 8443. Il firewall viene configurato da solo.

Cosa installa

nginx, PHP-FPM 8.3 (altre versioni dal pannello), MariaDB con phpMyAdmin, certbot, il firewall (ufw su Ubuntu, firewalld su AlmaLinux e Rocky) e fail2ban, gli strumenti per WordPress (WP-CLI, Redis), l'antivirus ClamAV, gli aggiornamenti di sicurezza automatici del sistema e il pannello KoaPanel come servizio. La posta è facoltativa e si attiva dal pannello quando vuoi.

2. Primo accesso

Alla fine lo script mostra l'indirizzo del pannello (https://IP-DEL-SERVER:8443/), il nome utente e la password dell'amministratore, salvati anche in /root/koapanel-install.log (leggibile solo da root): copiali in un gestore di password e poi cancella il file. Durante l'installazione il pannello chiede a Let's Encrypt un certificato valido anche per l'indirizzo IP, quindi di norma il browser non mostra avvisi; se la porta 80 e la 443 sono chiuse resta per il momento il certificato autofirmato e il browser lo segnala.

Da lì: crea il primo sito, attiva HTTPS, installa WordPress. Il manuale è anche dentro il pannello, e gli aggiornamenti arrivano dalla pagina Aggiornamenti.

3. Crea l'account gratuito

Nell'area clienti premi Accedi con Prime Software ID e scegli «Primo accesso»: ti arriva un link per email, scegli la password e sei dentro. Poi premi Attiva il piano gratuito, copia il codice di licenza e incollalo nel pannello in Piano e licenza.

Nell'area clienti trovi anche le richieste di assistenza, gli ordini con le fatture e, per le licenze a pagamento, lo spostamento su un altro server e la gestione dell'abbonamento. Un account ha un piano Gratuito, per un server.

4. Quando ti serve di più

Per più di 3 siti o per lavoro scegli un piano: nel pannello apri Piano e licenza, premi Passa a…, completa l'acquisto e il codice si attiva con un clic. Non serve reinstallare.

Serve una mano?

Se l'installazione non va a buon fine o vuoi che ti aiutiamo noi, scrivici: allega le ultime righe di /root/koapanel-install.log (senza la password).