--- title: "Guida all’installazione" description: "Installare Éclair CMS in 3 minuti: requisiti, download, caricamento via FTP o file manager, procedura guidata in 4 domande e prime impostazioni." url: "https://eclaircms.org/it/installazione" lang: "it" author: "Thierry Gustin" published: "2026-10-30" updated: "2026-10-31" --- # Guida all’installazione > **In breve** — Per installare Éclair CMS servono un hosting con PHP 8.1 o successivo (consigliato 8.3), Apache o LiteSpeed e un certificato HTTPS. Scarica l’archivio da 440 KB, carica il contenuto della cartella eclair nella cartella pubblica del tuo sito (file .htaccess compresi), apri l’indirizzo del sito e rispondi alle 4 domande della procedura guidata, entro 2 ore dalla tua prima visita. Installare Éclair CMS richiede circa 3 minuti: nessun database da creare, nessun file di configurazione da compilare. Carichi una cartella sul tuo hosting, apri l’indirizzo del tuo sito e una procedura guidata ti fa quattro domande. Questa guida illustra ogni passaggio con gli screenshot, e poi le impostazioni da fare subito dopo. > **Il tuo hosting è o2switch?** — Segui piuttosto [la guida dedicata a o2switch](https://eclaircms.org/it/installazione/o2switch): mostra ogni menu di cPanel, dal dominio al certificato HTTPS. Per provare Éclair senza hosting, vedi [l’installazione sul tuo computer](https://eclaircms.org/it/installazione/locale). ## Che cosa ti serve per installare Éclair CMS? Ti basta un normale hosting web, come un hosting condiviso da pochi euro al mese. Non serve alcun database. | Elemento | Minimo | Consigliato | | --- | --- | --- | | Versione di PHP | 8.1 | 8.3 o 8.4 | | Estensioni PHP indispensabili | `mbstring`, `json`, `dom`, `session` | attive di default quasi ovunque | | Estensioni PHP consigliate | — | `gd` (immagini WebP), `zip` (backup), `curl` (IndexNow, assistente IA), `zlib` (area di amministrazione tradotta) | | Server web | Apache o LiteSpeed con `.htaccess` | lo stesso, oppure Nginx con la [configurazione fornita](https://eclaircms.org/it/documentazione/sviluppatori) | | Certificato HTTPS | consigliato | Let’s Encrypt, gratuito presso quasi tutti i provider | | Spazio su disco | 1 MB per Éclair | più le tue immagini | | Database | nessuno | nessuno | Quasi tutti gli hosting condivisi vanno bene: o2switch, OVH, Hostinger, IONOS, PlanetHoster… E niente paura: la procedura guidata di installazione controlla tutto questo per te e ti spiega cosa correggere. ## Passaggio 1: scarica Éclair Scarica l’archivio ufficiale, poi estrailo sul tuo computer (doppio clic su Mac; su Windows, clic destro › Estrai tutto). [Scarica Éclair 1.7.0 (440 KB)](https://github.com/Jacckisback/eclair-cms/raw/main/dist/eclair-cms-1.7.0.zip) Troverai una cartella `eclair` e tre file di testo (leggimi, licenza MIT e note sui componenti di terze parti) che non occorre caricare. Ecco cosa contiene la cartella `eclair`: | Elemento | Ruolo | | --- | --- | | `index.php` | Il punto di ingresso: serve le pagine in cache senza caricare l’applicazione | | `.htaccess` | URL puliti, protezioni, compressione e cache del browser (file nascosto) | | `app/` | Il codice di Éclair, l’area di amministrazione e il tema | | `assets/` | Il CSS e il JavaScript dell’area di amministrazione, e il piccolo script del sito | | `data/` | I tuoi contenuti, le impostazioni e gli account, creati durante l’installazione e mai pubblici | | `cache/` | Le pagine già generate | | `media/` | Le tue immagini | | `eclair-config.exemple.php` | Un modello di impostazioni avanzate, facoltativo | ## Passaggio 2: carica i file sul tuo hosting L’obiettivo: far sì che `index.php`, `.htaccess` e le cartelle `app`, `assets`, `data`, `cache` e `media` si trovino **direttamente nella cartella pubblica del tuo sito**. A seconda del provider si chiama `public_html`, `www`, `htdocs` oppure ha il nome del tuo dominio. ### Con il file manager del tuo provider È il metodo più semplice, senza software da installare: 1. Apri il file manager dall’area clienti del tuo provider (in cPanel: **File › Gestione file**). 2. Vai nella cartella pubblica del tuo sito e carica l’archivio `eclair-cms-1.7.0.zip`. 3. Fai clic con il tasto destro sull’archivio, poi scegli **Estrai**: compare una cartella `eclair`. 4. Mostra i file nascosti (in cPanel: **Impostazioni › Mostra file nascosti**), apri la cartella `eclair`, seleziona **tutto** il suo contenuto, `.htaccess` compreso, e spostalo di un livello verso l’alto, nella cartella pubblica. 5. Elimina la cartella `eclair`, ormai vuota, e l’archivio. ### Con un programma FTP come FileZilla 1. Recupera le credenziali FTP dall’area clienti del tuo provider: server, nome utente, password (e porta 22 se il provider offre l’SFTP, più sicuro). 2. Connettiti con [FileZilla](https://filezilla-project.org/), gratuito, e apri la cartella pubblica del tuo sito nel riquadro di destra. 3. Attiva la voce del menu **Server** che forza la visualizzazione dei file nascosti (*Force showing hidden files* in inglese), altrimenti il `.htaccess` rischia di non essere caricato. 4. Nel riquadro di sinistra apri la cartella `eclair`, seleziona tutto il suo contenuto e trascinalo a destra. > **Non dimenticare il file .htaccess** — Il suo nome inizia con un punto: per impostazione predefinita è nascosto. Senza questo file, tutte le pagine tranne la home mostrano un errore 404. La procedura guidata ti avvisa se manca. ### E in una sottocartella o in un sottodominio? Funziona anche così. Per un sito all’indirizzo `esempio.it/sito/`, carica semplicemente i file nella cartella `sito`: Éclair rileva da solo la sottocartella. Per un sottodominio come `blog.esempio.it`, caricali nella cartella collegata a quel sottodominio. ## Passaggio 3: rispondi alle 4 domande della procedura guidata Per installare Éclair CMS non resta che aprire l’indirizzo del tuo sito nel browser: parte la procedura guidata di installazione, in italiano o in una delle altre 6 lingue proposte in alto a destra. > **Una finestra di 2 ore** — Per sicurezza, l’installazione va completata entro 2 ore dalla prima visita: altrimenti chiunque potrebbe impadronirsi di un sito caricato e poi dimenticato. Trascorso questo tempo, elimina il file `data/install-window.php` via FTP e ricarica la pagina. ### Schermata di benvenuto: il controllo del tuo hosting La procedura guidata controlla la versione di PHP, le estensioni, i permessi di scrittura delle cartelle, l’HTTPS e la riscrittura degli URL. Se tutto è verde, clicca su **Iniziamo**. Se un punto è rosso, ti spiega cosa correggere presso il tuo provider. ![Procedura guidata di installazione di Éclair, schermata di benvenuto: 14 punti verificati, l’hosting è pronto](https://eclaircms.org/media/2026/10/it-installer-welcome.webp) *«14 punti verificati: il tuo hosting è pronto».* ### Domanda 1: il tuo sito Inserisci il **Nome del sito**, un **Motto** facoltativo e la **Lingua del sito**, poi scegli il tipo di sito. Tutto si può modificare più tardi. ![Procedura guidata di installazione di Éclair, passaggio Il tuo sito: nome, motto, lingua e tipo di sito](https://eclaircms.org/media/2026/10/it-installer-site.webp) Il tipo scelto determina le prime pagine create per te: | Tipo | Cosa crea Éclair | | --- | --- | | 🏢 Sito vetrina | Home (banner, punti di forza, ultimi articoli), Servizi con FAQ, Chi siamo, Contatti, Blog e pagine legali | | ✍️ Blog | Home con gli ultimi articoli, Chi siamo, Contatti, una categoria «Guides» e pagine legali | | 🧑‍💻 Freelance / portfolio | Home a tuo nome, competenze, Chi sono, Blog, Contatti e pagine legali | | 🎯 Pagina unica | Una pagina di vendita (banner, punti di forza, FAQ, modulo) e le pagine legali, senza blog | ### Domanda 2: il tuo account Il tuo nome, la tua email e una password di almeno 10 caratteri. Le password troppo comuni vengono rifiutate e un indicatore ti mostra quanto è robusta la tua. ![Procedura guidata di installazione di Éclair, passaggio Il tuo account: nome, email e password con indicatore di robustezza](https://eclaircms.org/media/2026/10/it-installer-account.webp) > **Una password robusta e facile da ricordare** — Una frase di quattro parole, come `Luce-sulla-collina-2026`, è molto più robusta di una parola breve piena di simboli. Salvala nel tuo gestore di password. ### Domanda 3: la tua visibilità - **Google e Bing possono indicizzare il mio sito**: deseleziona se preferisci costruire il tuo sito con calma prima di mostrarlo. - **Le intelligenze artificiali (ChatGPT, Perplexity, Gemini…)**: *Ti diamo il benvenuto* (possono leggere e citare il tuo sito, consigliato), *Solo citazioni* (ti citano senza addestrare i loro modelli con i tuoi testi) oppure *No, grazie*. - **Indirizzo della tua area di amministrazione**: sostituisci `admin` con una parola scelta da te, oppure clicca su **Genera un indirizzo segreto**. Un indirizzo personale tiene lontani i bot malevoli. ![Procedura guidata di installazione di Éclair, passaggio Visibilità: indicizzazione Google e Bing, bot IA e indirizzo dell’area di amministrazione](https://eclaircms.org/media/2026/10/it-installer-visibility.webp) ### Domanda 4: il riepilogo Rileggi le tue scelte, poi clicca su **Crea il mio sito ⚡**. Éclair crea le tue pagine, un articolo di esempio, il tuo account, la sitemap e le icone del sito. ![Procedura guidata di installazione di Éclair, riepilogo delle scelte prima di creare il sito](https://eclaircms.org/media/2026/10/it-installer-summary.webp) ### È online! Una pioggia di coriandoli, e il tuo sito è pubblicato. **Annota bene l’indirizzo della tua area di amministrazione** (per esempio `https://il-tuo-sito.it/studio`) e salvalo nei preferiti: è da lì che accederai d’ora in poi. ![Fine dell’installazione di Éclair: il tuo sito è online, con l’indirizzo dell’area di amministrazione da salvare nei preferiti](https://eclaircms.org/media/2026/10/it-installer-done.webp) ## Passaggio 4: le tue prime impostazioni in 10 minuti La bacheca ti accoglie con un elenco **Primi passi**: ogni riga ti porta alla schermata giusta. ![Bacheca di Éclair subito dopo l’installazione, con l’elenco Primi passi](https://eclaircms.org/media/2026/10/it-dashboard-getting-started.webp) 1. **Aggiungi il tuo logo e il tuo colore** (Impostazioni › Aspetto): il contrasto dei colori resta leggibile in automatico. 2. **Personalizza la homepage**: sostituisci i testi di esempio con la tua offerta. 3. **Scrivi il tuo primo articolo**, aiutandoti con i punteggi SEO e GEO dell’editor. 4. **Completa il tuo profilo autore**: foto, ruolo e biografia rafforzano la fiducia di Google e delle IA. 5. **Attiva l’autenticazione a due fattori** (Il mio profilo › Autenticazione a due fattori). 6. **Completa le note legali**, obbligatorie in Francia come in Spagna. 7. **Collega il tuo sito a Google Search Console** (Impostazioni › SEO): incolla il tag di verifica, Éclair ne estrae il codice. Aggiungi un ottavo passaggio: in **Sicurezza**, clicca su **Verifica l’indirizzo del sito**. Una volta confermato l’indirizzo, Éclair reindirizza i visitatori all’indirizzo ufficiale (con o senza www) e impone l’HTTPS. ![Pagina Sicurezza dell’area di amministrazione di Éclair: livello di protezione, test di protezione delle cartelle e integrità dei file](https://eclaircms.org/media/2026/10/it-security-page.webp) *La pagina Sicurezza: livello di protezione, test delle cartelle protette e controllo di integrità dei file.* Il dettaglio di ogni impostazione è in [Primi passi dopo l’installazione](https://eclaircms.org/it/documentazione/primi-passi). ## Cosa fare se l’installazione non parte? | Cosa vedi | Soluzione | | --- | --- | | «Éclair a besoin de PHP 8.1 ou plus récent» (messaggio in francese: «Éclair richiede PHP 8.1 o successivo») | Cambia la versione di PHP nell’area clienti del tuo provider, poi ricarica la pagina | | Errore 404 su tutte le pagine tranne la home | Il `.htaccess` non è stato caricato: mostra i file nascosti e caricalo di nuovo | | Errore 500 subito dopo il caricamento | Una direttiva del `.htaccess` viene rifiutata: contatta il tuo provider ([dettagli](https://eclaircms.org/it/documentazione/risoluzione-problemi#error-500)) | | «Installazione bloccata» | La finestra di 2 ore è scaduta: elimina `data/install-window.php` e ricarica la pagina | | Una cartella segnalata come «non scrivibile» | Assegna i permessi 755 alle cartelle `data`, `cache` e `media` con il tuo programma FTP | Per tutto il resto, consulta [la guida alla risoluzione dei problemi](https://eclaircms.org/it/documentazione/risoluzione-problemi) o [scrivimi](https://eclaircms.org/it/contatti). ## Domande sull’installazione ### Quanto tempo ci vuole per installare Éclair? Circa 3 minuti: il tempo di caricare meno di 1 MB di file e di rispondere alle 4 domande della procedura guidata. Calcola qualche minuto in più se devi prima attivare il certificato HTTPS o cambiare la versione di PHP. ### Serve creare un database per installare Éclair CMS? No. Éclair non usa alcun database: i tuoi contenuti sono file protetti nella cartella `data`. Non devi creare nessun database né inserire credenziali MySQL. ### Posso installare Éclair su un hosting che contiene già un sito? Sì, in una sottocartella (per esempio `esempio.it/nuovo/`) o su un sottodominio. Éclair rileva automaticamente la cartella in cui è installato. ### Posso provare Éclair prima di metterlo online? Sì: installalo sul tuo computer con un server locale, seguendo [l’installazione sul tuo computer](https://eclaircms.org/it/installazione/locale). Potrai poi spostare l’intera cartella presso il tuo provider. ### Come si disinstalla Éclair? Elimina i suoi file e le sue cartelle: poiché non c’è alcun database, sul tuo hosting non resta nient’altro. Se vuoi conservare i tuoi contenuti, ricordati prima di scaricare un backup dalla pagina Sicurezza. [Installa Éclair su o2switch, passo dopo passo](https://eclaircms.org/it/installazione/o2switch)