Maintenance Page

Custom Maintenance Page

You can configure your App with a custom maintenance page.

This page will be served by your HTTP(S) Endpoints when requests time out, or if your App is down.

To configure one, set the MAINTENANCE_PAGE_URL Configuration variable on your app:

aptible config:set --app "$APP_HANDLE" \
        MAINTENANCE_PAGE_URL=http://...

Enclave will download and cache the maintenance page when deploying your app. If it needs to be served, Enclave will serve the maintenance page directly to clients.

This maeans:

  • Make sure your maintenance page is publicly accessible for Enclave can download it.
  • Don’t use relative links in your maintenance page: the page won’t be served from its original URL, so these will probably break.

Brickwall

If all your app Containers are down, Enclave will route your traffic to an error page server: Brickwall.

Brickwall will serve your Custom Maintenance Page if you set one up, and fallback to a generic Enclave error page if you did not.

You usually shouldn’t need to, but you can identify responses coming from Brickwall from the Server header, which will be set to brickwall.