--- title: "Risoluzione dei problemi" description: "Risoluzione dei problemi di Éclair CMS: password dimenticata, installazione bloccata, errore 404 o 500, immagini non convertite, email, debug, proxy." url: "https://eclaircms.org/it/documentazione/risoluzione-problemi" lang: "it" author: "Thierry Gustin" published: "2026-10-30" updated: "2026-11-01" --- # Risoluzione dei problemi > **In breve** — Questa guida alla risoluzione dei problemi di Éclair CMS dà la soluzione ai problemi più frequenti: password dimenticata o telefono 2FA perso (file data/reset.php), installazione bloccata dopo 2 ore, errore 404 dovuto a un .htaccess assente, errore 500, immagini non convertite in WebP, email del modulo non ricevute, modalità debug e indirizzo IP falsato da un proxy. Questa guida alla risoluzione dei problemi di Éclair CMS raccoglie i problemi più frequenti e la loro soluzione, dalla password dimenticata all’errore 404. Ogni sezione corrisponde a un messaggio o a un sintomo preciso: usa l’indice per andare dritto al tuo. La maggior parte si risolve in due minuti, con il tuo programma FTP o il file manager del tuo provider. ## Password dimenticata o telefono dell’autenticazione a due fattori perso? Parti dalle soluzioni più semplici: - **Esiste un altro amministratore**: in Utenti, può cliccare su **Reimposta password** (viene creata una password temporanea) o su **Disattiva la 2FA** del tuo account. - **Hai perso il telefono, non i tuoi codici**: accedi con uno dei tuoi 8 codici di recupero al posto del codice a 6 cifre. Se sei l’unico amministratore, usa il recupero via FTP. Crea un file `data/reset.php` che contenga esattamente queste tre righe: ```text tuo-indirizzo@email.it LaTuaNuovaPassword2026 ``` Entro 24 ore, **accedi con questa email e questa nuova password**. La password viene sostituita, l’autenticazione a due fattori di questo account viene disattivata, le tue altre sessioni vengono chiuse e il file viene eliminato automaticamente. > **Perché è sicuro** — Nessun altro può attivare questo recupero: serve un accesso FTP per depositare il file, e conoscerne il contenuto per usarlo. Un file senza la prima riga viene rifiutato ed eliminato. La nuova password deve rispettare le regole abituali: minimo 10 caratteri, nessuna password troppo comune. ## «Installazione bloccata»: cosa fare? Per sicurezza, l’installazione va completata **entro 2 ore** dalla prima visita: altrimenti chiunque potrebbe impadronirsi di un sito caricato e poi dimenticato. Scaduto questo tempo, elimina via FTP il file `data/install-window.php`, poi ricarica la pagina: si apre una nuova finestra di 2 ore. ## Perché nella pagina Sicurezza l’indirizzo del sito risulta non verificato? Il tuo server non riesce a contattare se stesso all’indirizzo del sito: firewall del provider, DNS non ancora propagato, dominio in corso di trasferimento… Il sito funziona normalmente, ma senza reindirizzamento all’indirizzo ufficiale (con o senza www, da http a https). Clicca su **Verifica l’indirizzo del sito** quando il dominio è a posto. ## Perché compare un errore 404 su tutte le pagine tranne la homepage? Il file `.htaccess` non è stato caricato, perché è un file nascosto, oppure la riscrittura degli URL è disattivata. Attiva «Mostra file nascosti» nel tuo programma FTP e ricaricalo nella radice del sito. Se il tuo provider lo richiede, togli il commento alla riga `RewriteBase /` del `.htaccess`. > **La diagnosi dell’installatore** — Durante l’installazione, la riga «Indirizzi puliti (riscrittura degli URL)» ti dice già se il `.htaccess` funziona. Su Nginx, che ignora questo file, copia la configurazione della guida [Per sviluppatori](https://eclaircms.org/it/documentazione/sviluppatori). ## Cosa fare in caso di errore 500 subito dopo il caricamento? Il tuo provider rifiuta una direttiva del `.htaccess`. È molto raro: vengono usate solo direttive tollerate sugli hosting condivisi. Elimina il blocco in questione o contatta il tuo provider. Se compare la pagina «Oups, un court-circuit.» (in francese, «Oops, un cortocircuito») con un riferimento, il dettaglio dell’errore si trova in **Sicurezza › Ultimi errori tecnici**. ## Perché le immagini non vengono convertite in WebP? Sul tuo hosting manca l’estensione PHP GD, o il suo supporto WebP. Attivala nel pannello PHP del tuo provider. Nel frattempo, le tue immagini restano in JPG o PNG: il sito funziona, è solo un po’ meno leggero. ## Perché non ricevo le email del modulo? Niente panico: i messaggi vengono salvati anche nell’amministrazione, nel menu **Messaggi**. Controlla poi il campo **Ricevi i messaggi all’indirizzo** in **Impostazioni › Contatti**; di default è l’email del primo amministratore. Alcuni provider richiedono che il mittente appartenga al dominio del sito: crea un indirizzo email sul tuo dominio, se serve. ## Come attivare la modalità debug? Crea un file `eclair-config.php` nella radice del sito, accanto a `index.php`, sul modello di `eclair-config.exemple.php`: ```php **Solo se necessario** — Lascia «No (consigliato)» se il tuo sito non è dietro un proxy: altrimenti un visitatore potrebbe fornire un falso indirizzo IP. Éclair legge solo l’ultimo indirizzo dell’header, quello aggiunto dal proxy. ## Éclair dice di aver bisogno di PHP 8.1 o successivo: cosa fare? Se la pagina mostra «Éclair a besoin de PHP 8.1 ou plus récent» (in francese, «Éclair ha bisogno di PHP 8.1 o successivo»), il tuo hosting usa una versione di PHP troppo vecchia. Cambiala nell’area clienti del tuo provider, spesso con un clic, poi ricarica la pagina. Éclair funziona da PHP 8.1 a 8.5; scegli l’8.3 o successivo, se possibile. La guida [Installare Éclair su o2switch](https://eclaircms.org/it/installazione/o2switch) mostra dove si trova questa impostazione in cPanel. ## L’assistente IA non risponde? Chiave rifiutata, credito esaurito, budget del mese raggiunto, connessioni in uscita bloccate: ogni messaggio ha la sua soluzione nella guida all’[assistente IA](https://eclaircms.org/it/documentazione/assistente-ia#if-the-assistant-does-not-respond). ## Il tuo problema non è in questa guida alla risoluzione dei problemi di Éclair CMS? Annota il messaggio di errore esatto, il tuo provider e la tua versione di PHP, poi scrivimi tramite la pagina [Contatti](https://eclaircms.org/it/contatti). Puoi anche segnalare un problema su [GitHub](https://github.com/Jacckisback/eclair-cms/issues): la sua soluzione arricchirà questa guida alla risoluzione dei problemi di Éclair CMS per tutti gli utenti. ## Domande sulla risoluzione dei problemi ### Il file data/reset.php funziona se ho attivato l’autenticazione a due fattori? Sì. L’accesso con l’email e la nuova password del file disattiva l’autenticazione a due fattori di quell’account. Riattivala poi in Il mio profilo. ### Dove trovo i file nascosti come .htaccess? Nel tuo programma FTP, attiva l’opzione «Mostra file nascosti». Nella Gestione file di cPanel, la trovi in Impostazioni › «Mostra file nascosti» (*Paramètres › Afficher les fichiers masqués* nell’interfaccia in francese). ### Come scopro quale errore si è verificato? Apri Sicurezza › Ultimi errori tecnici, oppure attiva temporaneamente la modalità debug con un file eclair-config.php. Ricordati di eliminarlo dopo. ### Il mio sito mostra una pagina bianca: da dove parto? Controlla la versione di PHP (8.1 minimo), poi attiva la modalità debug per mostrare l’errore. Nella maggior parte dei casi manca un file o un’estensione PHP.