The Magento Expert

Enabling Maintenance Mode and Allowing Your Own IP Address

Mex — Wed, 14 Oct 2026 20:47:05 +0000

During upgrades or major changes, you may want to block visitors temporarily while continuing to work on the store yourself. Magento 2 can enable maintenance mode and exempt selected IP addresses.

Enable maintenance mode and allow your own IP address with:

bin/magento maintenance:enable --ip=123.123.123.123

Other visitors will then see the maintenance page while the allowlisted IP can still access the store.

Check the current status at any time with:

bin/magento maintenance:status

When the work is finished, disable maintenance mode again:

bin/magento maintenance:disable

This is particularly useful for Magento upgrades and deploymentsbecause you can test the frontend before reopening the store to everyone.

Disable maintenance mode for certain IP

Mon, 29 Jul 2019 06:45:03 +0000

With Magento 2 it is possible to disable the maintenance mode for only a certain IP. Disabling the Magento 2 maintenance mode for your IP lets you browse the frontend and admin area as normal. All other visitors will still get the maintenance mode screen.

Run this from the Magento 2 root directory to disable maintenance mode for your IP:

php bin/magento maintenance:enable --ip="12.345.678.123"

Deactive your IP again:

php bin/magento maintenance:disable --ip="12.345.678.123"

Deactivate / bypass maintenance mode for IP

Fri, 15 Mar 2019 08:15:02 +0000

When working on your Magento 2 shop it is always a good idea to put it in maintenance mode. The only problem with this approach is that nobody, not even you :), can now work with the store. To bypass the maintenance mode for your IP, simply run the following command from your Magento 2 root directory. This way you can work as normal, all other visitors will get the maintenance mode message.

php bin/magento maintenance:enable --ip="12.345.678.123"

Undo:

php bin/magento maintenance:disable --ip="12.345.678.123"

Disabling maintenance mode for a specific IP address

Mex — Sat, 02 Mar 2019 07:23:50 +0000

Magento 2 allows you to disable maintenance mode for a specific IP address. This means you can keep using the storefront and admin area while carrying out maintenance, while other visitors see the maintenance notice.

To allow your own IP address and continue working on your Magento 2 store, use:

php bin/magento maintenance:enable --ip="12.345.678.123"

Deaktivierung mittels:

php bin/magento maintenance:disable --ip="12.345.678.123"

Restricting maintenance mode by IP address

Mex — Tue, 04 Apr 2017 11:45:43 +0000

When you create maintenance.flag in Magento’s root directory, the entire store becomes unavailable, including the admin area. That is inconvenient if you still need to work on the site. Add the following code at the beginning of index.php to allow specific IP addresses to access the store.

$ip = $_SERVER['REMOTE_ADDR'];
$allowed = array('1.2.3.4', '1.1.1.1'); // IP addresses allowed to access the store

if (!in_array($ip, $allowed)) {
    die('The store is being updated. Thank you for your patience!');
}

You can also output HTML to create a more attractive maintenance page.