Come attivare la modalità di manutenzione in Magento 2

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 file var/.maintenance.ip possono 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.