Difference between revisions of "Enable/Disable Magento2 Maintenance Page"

Revision as of 16:45, 23 January 2018

Enable/Disable Magento2 Maintenance Page

Log in to the Magento server as, or switch to, a user who has permissions to write to the Magento file system.

su <Magento file system owner> -s /bin/bash -c <command>

Magento uses maintenance mode to disable bootstrapping; for example, while you’re maintaining, upgrading, or reconfiguring your site.

Magento detects maintenance mode as follows:

If var/.maintenance.flag does not exist, maintenance mode is off and Magento operates normally. Otherwise, maintenance mode is on unless var/.maintenance.ip exists:

var/.maintenance.ip can contain a list of IP addresses. If an entry point is accessed using HTTP and the client IP address corresponds to one of the entries in that list, then maintenance mode is off.

Command usage:

magento maintenance:enable [--ip=<ip address> ... --ip=<ip address>] | [ip=none]

magento maintenance:disable [--ip=<ip address> ... --ip=<ip address>] | [ip=none]

magento maintenance:status

where

--ip=<ip address> is an IP address to exempt from maintenance mode (for example, developers doing the maintenance). To exempt more than one IP address in the same command, use the option multiple times.

For example, to enable maintenance mode with no IP address exemptions:

magento maintenance:enable

To enable maintenance mode for all clients except 192.0.2.10 and 192.0.2.11:

magento maintenance:enable --ip=192.0.2.10 --ip=192.0.2.11