How to customise the maintenance page?

[henrywright]

The NodeBB Community Forum maintenance page looks really cool:

Can we customise our own NodeBB maintenance page? If so, how can we do that?

[henrywright]

I did a bit of reading on this. You just add this to your Nginx server block:

error_page 502 /maintenance.html;
location = /maintenance.html {
        root /usr/share/nginx/html;
        internal;
}

Then create /usr/share/nginx/html/maintenance.html and put whatever markup you want inside it.

[psychobunny]

Woops, I forgot to respond to this, glad you figured it out.

If you like the design, I'm more than happy to share the code so you can customise it for your own forums. There's a catch - I'll only share it if you figure out the small easter egg on that page, try to find it next time we do maintenance

[henrywright]

@psychobunny

If you like the design, I'm more than happy to share the code so you can customise it for your own forums

That'd be great! Thanks

OK, now for some Easter egg hunting... haha

[julian]

Hahha good luck, the forum doesn't go down often

That's not an invitation to do nefarious things though...

[henrywright]

@julian I'm hoping to catch a restart but I'm not very confident I will

[Charly86]

Love it too, anyone has the nodeBB html source code for 502 static maintenance.html ?
I would like to give a try on my nginx server
thanks

[psychobunny]

If nobody has figured out the Easter egg in a week I won't be mean and will post a gist

But seriously, 0.8 just got out so expect a bunch of updates as we usually find one or two bugs haha (I have two major ones I'm fixing for Monday)

EDIT: @henrywright that would be a cool addition to our docs BTW, if you were interested in adding a howto for 502 pages, probably belongs in the nginx section

[henrywright]

@psychobunny actually I did look for an article on this in the docs before posting this topic but couldn't find anything so an article would be useful I'm sure of it! Will update the docs right after I've done it myself so I can outline the steps I took.

[julian]

@henrywright Yeah the error page itself is just html, and the line to serve it in nginx is quite small, so I didn't think it was worth mentioning

[henrywright]

@julian at first I didn't think of Nginx at all; instead, I was focusing on Settings > Maintenance Mode and thinking there was a setting in that section I was overlooking. But then the penny dropped ha

[A Former User]

@psychobunny I know, i know! If you click on the inscription 502 - it will jump.

[Kowlin]

Hmm I'll see if I can so something with apache in a similar way. This seems like something nodebb can expand on

[julian]

@Kowlin What do you mean? You can already customise the maintenance page by modifying the template.

If you get the page served by nginx, then nodebb is DOWN and there isn't anything NodeBB can do about that!

[Kowlin]

@julian this is why I need to not take breaks from software I follow. I'll just end up being confused what in talking about

[henrywright]

@Kowlin with Apache you can set the ErrorDocument directive in your .htaccess doc

[henrywright]

@psychobunny I think I got it?

[drew]

@henrywright said:

I think I got it?

NICE WORK!

@psychobunny I'd say he's earned us a gist!

[julian]

@henrywright Yep, you found it

[Fastidious]

@drew so, where do we get that sexy 502 page now?