Hai mai dovuto aggiornare il tuo e-commerce Magento e temuto di perdere clienti a causa di errori temporanei o downtime?
La modalità manutenzione di Magento 2 è la soluzione perfetta: ti permette di effettuare aggiornamenti, modifiche o test tecnici senza interrompere la navigazione dei tuoi clienti.
Durante la manutenzione, i visitatori vedranno una semplice schermata “Sito in manutenzione”, mentre tu potrai continuare a lavorare sul backend in sicurezza.
In questa guida vedremo come attivare, configurare e disattivare la modalità manutenzione in Magento 2, oltre ad alcuni trend e best practice per gestire al meglio il tuo store.
Cos’è la modalità manutenzione in Magento 2
La modalità manutenzione di Magento 2 blocca temporaneamente il frontend del sito, permettendoti di effettuare aggiornamenti o configurazioni senza che i clienti vedano errori o contenuti incompleti.
Tecnicamente, Magento controlla la presenza del file var/.maintenance.flag:
- Se non è presente, il sito è online e accessibile.
- Se è presente, la modalità manutenzione è attiva.
Tuttavia, gli indirizzi IP inseriti nel filevar/.maintenance.ippossono comunque accedere al sito (utile per test e verifiche interne).
Cosa serve per attivare la modalità manutenzione
Accedi al server Magento 2 con accesso al file system e aggiungi:
\<your Magento install dir\>/bin
Puoi eseguire i comandi in due modi:
cd \<your Magento install dir\>/bin and use ./magento \<command name\>
oppure
type php \<your Magento install dir\>/bin/magento \<command name\>
Come attivare o disattivare la modalità manutenzione in Magento 2
1. Accedi alla directory di lavoro
Prima di attivare la modalità di manutenzione devi:
- Accedere al tuo account SSH
- Inserire il comando:
cd ~/public_html
Oppure, se è in una sottocartella chiamata magento1:
cd \~/public\_html/magento1
2. Consenti l’accesso a determinati IP
Puoi permettere ad un indirizzo specifico (per esempio 123.45.67.89) di accedere allo storefront del sito anche durante la manutenzione:
bin/magento maintenance:allow-ips 123.45.67.89
Puoi aggiungere più IP:
bin/magento maintenance:enable --ip=123.45.67.89 --ip=123.45.67.90
3. Attiva la modalità manutenzione
Per mettere il sito in manutenzione:
bin/magento maintenance:enable
I visitatori vedranno un messaggio “Service Unavailable”, mentre chi accede da un IP consentito continuerà a vedere il sito normalmente.
4. Personalizza la pagina di manutenzione
Per evitare che la schermata “Sito in manutenzione” risulti impersonale, puoi personalizzare il file:
pub/errors/default/503.phtml
oppure creare versioni dedicate per sottodomini o lingue diverse.
Puoi anche aggiungere un countdown, un messaggio personalizzato o il logo del brand, per mantenere l’attenzione degli utenti durante i lavori.
5. Verifica lo stato della manutenzione
Per sapere se la modalità manutenzione è attiva:
bin/magento maintenance:status
6. Disattiva la modalità manutenzione
Una volta terminati gli aggiornamenti:
bin/magento maintenance:disable
Il file var/.maintenance.flag verrà eliminato e il sito tornerà accessibile a tutti.
Trend e best practice nella manutenzione di Magento 2
1. Zero Downtime Updates
Sempre più merchant adottano processi di deploy senza interruzioni, grazie a comandi come:
bin/magento magefan:zero-downtime:deploy
In questo modo puoi aggiornare il sito senza mai renderlo offline per i clienti.
2. Pagine di manutenzione personalizzate
Le aziende più attente all’esperienza utente creano pagine di manutenzione brandizzate, con:
- Timer di conto alla rovescia
- Link ai social
- Messaggi di brand awareness
- Pulsanti per iscriversi alla newsletter
3. Strumenti CLI più semplici
I comandi per la manutenzione sono sempre più intuitivi:
php bin/magento maintenance:disable
php bin/magento maintenance:status
Perfetti anche per store manager o agenzie che gestiscono più installazioni Magento.
4. Sicurezza e prestazioni migliorate
Durante la manutenzione è buona pratica:
- Attivare la modalità developer
bin/magento deploy:mode:set developer
- Effettuare un backup completo prima di ogni intervento
- Limitare l’accesso solo agli IP fidati
Questo mantiene il sito sicuro e stabile anche durante le operazioni tecniche.
Domande frequenti sulla modalità manutenzione
1. Quando dovrei usare la modalità manutenzione?
Durante aggiornamenti, fix o modifiche importanti. Serve a evitare che i clienti vedano errori temporanei o parti del sito non finite.
2. Posso continuare a vedere il sito durante la manutenzione?
Sì, basta aggiungere il tuo IP con il comando maintenance:allow-ips.
3. Come tolgo la manutenzione?
Usa bin/magento maintenance:disable per riattivare il sito.
4. È obbligatoria?
Non è obbligatoria, ma altamente consigliata ogni volta che si interviene sul codice o sui moduli di Magento.
Conclusione
Attivare la modalità manutenzione in Magento 2 è una pratica semplice ma fondamentale per garantire:
- Aggiornamenti senza downtime
- Esperienza utente fluida
- Sicurezza durante gli interventi tecnici
Con pochi comandi puoi aggiornare, testare e migliorare il tuo e-commerce senza mai perdere visitatori.
Un piccolo accorgimento tecnico che fa una grande differenza nella professionalità del tuo store Magento.