H2O

the optimized HTTP/1.x, HTTP/2 server

Powered by Oktavia

Configure > Errordoc Directives

This document describes the configuration directives of the errordoc handler.

Description:

Specifies the content to be sent when returning an error response (i.e. a response with 4xx or 5xx status code).

The argument must be a mapping containing following attributes, or if it is a sequence, every element must be a mapping with the following attributes.

  • status - three-digit number indicating the status code
  • url - URL of the document to be served

URL can either be absolute or relative. Only content-type, content-language, set-cookie headers obtained from the specified URL are served to the client.

Example. Set error document for 404 status
error-doc:
  status: 404
  url: /404.html
Example. Set error document for 500 and 503 status
error-doc:
  - status: 500
    url: /internal-error.html
  - status: 503
    url: /service-unavailable.html

Level:
global, host, path, extension