Easy maintenance mode with nginx

Posted on Mon 20 August 2018 in Tech

So I combined a few solutions I found online to come up with a quick way to set up maintenance mode using nginx. Ideally it shouldn't happen but in times of emergency in can be good to knock up a quick maintenance page for everyone but your own internal ips.

Nginx Config

So here's the configuration I use for nginx, it starts with setting the internal ips of your company in the main nginx config file. Then in the actual vhost, you can set it to watch for the existence of a maintenance_on.html and when it exists, throw a 503 and use the maintenance page as your 503 error page.

How to use

By default I have the file named as maintenance_off.html, so it's only a simple move operation to turn on maintenance mode. For the content of my maintenance file, I generally use this self-contained static html file to serve out a message to customers.

Note: Any sort of conditionals going on on your web server is likely to slow things down by a few milliseconds. Again you're asking your web server to check against network and the disk per request, then make a decision, so bear this in mind before implementing a solution like this.