Bespoke Maintenance Page

During maintenance period you can display your own fully styled static site instead of the default site.

Other than a few simple restrictions you have the full power of static HTML and CSS at your disposal.

Restrictions

The site is displayed instead of the requested URL when in maintenance and is rooted in the 'system' directory of the web root.

So all images and CSS must have full paths from the root, e.g /system/stylesheets/main.css, /system/images/logo.png

The entire site must run from a file called 'index.html' again rooted in /system. If the gem detects this is missing it will install the default maintenance site instead.

Default maintenance page

By default the maintenance site is stored in:

/home/rails/appname/shared/system

on all the web servers you have defined.

Creating a shared maintenance page

You can use the shared area system to point the maintenance page at your shared files. Simply add public/system to your shared directories, e.g.

set :global_shared_dirs, %w(public/system)

and upload your maintenance site to that directory.

docs/gemv2/maintenance.txt · Last modified: 2008/09/29 14:27 by neilw