The maintenance page shows when it shouldn't
People see the maintenance page although you didn't turn it on, after you turned it off, or although their IP address should get in. Or visitors still get in during maintenance. Find which switch is behind it.
- Applies to
- Core 12.7 and later
- Who can do this
- Platform owner, Administrator
- Permission
feature.core. maintenance_ mode.edit - Where
- Configurations › General Settings › Maintenance Mode
On this page
Symptom
People see a maintenance page instead of Laramin. There are two kinds, and they have different causes:
| The page shows | What it is | Go to |
|---|---|---|
| A 503 — Service Unavailable badge, your Maintenance Title (We'll be back soon unless you changed it), your message and your system name | Laramin's own maintenance mode | 1 to 4 |
| 503 · Service Unavailable above the heading Under Maintenance, and "We are temporarily offline for updates. We'll be back online shortly. Thank you for your patience." | The server's maintenance mode, outside Laramin's settings | 5 |
Or the opposite: Laramin is in maintenance, but visitors still get in. Go to 6.
Check these, in order
1. You aren't a super admin
While maintenance is on, only super admins and the addresses in Bypass IPs get through to the website and the admin. Administrators can still sign in, but then see the maintenance page too. The mobile app is closed to super admins as well: only an address in Bypass IPs gets through there. See The app shows a maintenance screen.
Fix: Wait for maintenance to end, or ask a super admin to add your address to Bypass IPs. See Turn on maintenance mode.
Tip: To check what visitors see, open Laramin in a private browser window. Signed in as a super admin, you never see the maintenance page.
2. A scheduled window is running
Open Configurations › General Settings › Maintenance Mode. If Start Date / Time and End Date / Time are both set, Laramin closes between them, even with Maintenance Mode off.
The times are read in the installation's time zone, the Default Timezone on the System panel, not in yours. So a window can start hours earlier or later than you meant. See Times are shown hours off.
Fix: Clear both times, check that Maintenance Mode is off, and select Save changes. Or set the times again in the installation's time zone. The tooltip on each field names it.
3. Nobody can sign in to switch it off
Fix: Ask whoever runs your server to run this. It turns maintenance off and clears a scheduled window too:
Couldn't copy. Select the code and press Ctrl+C (⌘+C on a Mac).
php artisan app:maintenance offIt answers Maintenance mode is OFF.
4. An address in Bypass IPs isn't let through
Laramin compares Bypass IPs with the address it sees. If Laramin runs behind a load balancer, CDN or reverse proxy that it hasn't been told about, every visitor seems to come from the proxy's address, so your own address never matches.
Fix: Ask whoever runs your server to set TRUSTED_PROXIES in your server's settings file to the proxy's address range, then run php artisan config:clear. Also check the address you entered: each one is an IP address or a range such as 203.0.113.0/24.
5. The server's own maintenance mode is on (platform owner)
The page with Under Maintenance comes from the server's own maintenance mode, which php artisan down turns on. Deployment scripts often use it. Laramin's Maintenance Mode switch doesn't control it, and super admins can't get past it either.
Fix: Ask whoever runs your server to finish or check the deployment, then run:
Couldn't copy. Select the code and press Ctrl+C (⌘+C on a Mac).
php artisan up6. Visitors still get in during maintenance
- They're super admins, or their address is in Bypass IPs. That's expected.
- Bypass IPs is empty and Laramin runs behind a proxy on the same server. With Bypass IPs empty, Laramin lets in requests from the server itself (
127.0.0.1). Behind a reverse proxy on the same machine that Laramin isn't told about, every visitor seems to come from127.0.0.1, so everyone gets in.
Fix: Ask whoever runs your server to set TRUSTED_PROXIES, as in check 4. Or fill in Bypass IPs with your own addresses: the server itself is then no longer let in automatically.
Still not working?
Raise a ticket from Support Center in your Laramin app. Include this page's link, a screenshot of the maintenance page, and the Start Date / Time and End Date / Time on the Maintenance panel.
Thanks. That helps us decide what to write next.
Thanks for telling us what was missing.
You already answered for this article today. Thanks.
We got a lot of answers from your network just now. Try again in a few minutes.
We couldn't send that. Check your connection and try again.
Links in this article
Printed from help.laramin.in. The online article may have changed since.