Tutte le sezioni del manuale

DocumentazioneInstallazione

Installazione

Koapanel si installa su un server Ubuntu 24.04 appena creato, in pochi minuti. Il piano Gratuito (fino a 3 siti, uso personale) è attivo da subito: non serve nessun codice.

Requisiti

  • Un server Ubuntu 24.04 LTS nuovo (VPS o dedicato), con accesso root. Non installarlo su un server che ospita già siti o un altro pannello.
  • Almeno 2 GB di RAM consigliati: posta e antimalware si adattano alla memoria disponibile.
  • Porte 80 e 443 raggiungibili per i siti e per i certificati Let's Encrypt; il pannello usa la porta 8443.

1. Richiedi l'installer

L'installer è composto da due file: il programma del pannello (panel-agent) e lo script install.sh. In questa fase di lancio li mandiamo su richiesta: compila il modulo e ricevi i link per email.

2. Avvia l'installazione

Copia i due file sul server (per esempio con scp) e, come root, nella stessa cartella:

$ chmod +x install.sh
$ sudo PANEL_BINARY=./panel-agent PANEL_LE_EMAIL=tu@tuodominio.it ./install.sh

Lo script installa nginx, PHP-FPM, MariaDB, certbot, ufw, fail2ban, phpMyAdmin, gli strumenti per WordPress (WP-CLI, Redis) e ClamAV, poi avvia il pannello come servizio. Si ferma se trova un pannello già installato.

Opzioni utili (variabili d'ambiente):

  • PANEL_PHP=8.3 — versione PHP iniziale (le altre si installano dal pannello)
  • PANEL_PORT=8443 — porta HTTPS del pannello
  • PANEL_MAIL=1 — attiva subito anche la posta (si può fare dopo dal pannello)
  • PANEL_ADMIN_USER=admin — nome dell'amministratore

3. Primo accesso

Alla fine lo script mostra una sola volta l'indirizzo del pannello (https://IP-DEL-SERVER:8443/), il nome utente e la password dell'amministratore: salvali in un gestore di password. Il certificato iniziale è autofirmato: il browser lo segnala la prima volta.

Da lì: crea il primo sito, attiva HTTPS, installa WordPress. Il manuale è anche dentro il pannello.

4. Quando ti serve più spazio

Per più di 3 siti o per lavoro scegli un piano: dal pannello, in Piano e licenza, premi Passa a…, completa l'acquisto e incolla il codice. Non serve reinstallare.