Installazione

Questa procedura descrive una nuova installazione da pacchetto distribution. Per un sito già online usa invece la pagina Aggiornamenti.

1. Scarica ed estrai la distribuzione

Procurati il pacchetto pacchetto di distribuzione Ciarvi della versione scelta della versione che vuoi installare. Estrailo integralmente, inclusi i file nascosti come .htaccess.

La struttura prevista è:

httpdocs/
├── core/
├── private/cms/
└── public_html/

Configura il dominio perché punti a public_html/, quando il provider lo consente.

2. Imposta il token di installazione

Su un server pubblico il wizard richiede un token. Configuralo in core/config.local.php o nella variabile d'ambiente PIUMA_INSTALL_TOKEN.

Per generarne uno casuale:

php -r "echo bin2hex(random_bytes(48));"

Trattalo come una credenziale: non pubblicarlo in screenshot, commit Git o file esposti sul web.

3. Apri il wizard

Visita l'indirizzo del sito seguito da /install. La procedura verifica ambiente e percorsi, quindi richiede le informazioni iniziali del sito e dell'utente amministratore. Risolvi le verifiche bloccanti prima di continuare.

Quando termina, l'installer viene disattivato e puoi procedere al login.

4. Controlla il sito appena installato

1. Accedi al pannello amministrativo.
2. Apri Sistema → Health e verifica che non vi siano errori.
3. Configura e prova l'invio email, se utilizzato.
4. Prepara un backup iniziale da conservare anche fuori dall'hosting.
5. Verifica che il sito pubblico, il tema e i link funzionino con HTTPS.

Per il server pubblico consulta anche Sicurezza.