How to customise the maintenance page?

Henry Wright

The NodeBB Community Forum maintenance page looks really cool:

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

Henry Wright

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

Henry Wright

@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...

Henry Wright

@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

Henry Wright

@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

Henry Wright

@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

? Offline

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

Robert

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!

Robert

@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

Henry Wright

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

Henry Wright

@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?