Skip to main content
OCLC Support

Error pages

Many of the error pages presented by EZproxy to remote users can be replaced with your own pages.

To override an existing error page, create a file using the name that appears below in the docs subdirectory. These files may contain the following special sequences:

term Behavior
^^ Send a caret (^).
^H Send just the hostname portion of the destination URL.
^L Insert the login URL for this server (e.g., http://ezproxy.yourlib.org:2048/login).
^U Destination URL in edited format, suitable for use in forming a destination URL such as for part of an "href" tag.
^0 For limit.htm, send the maximum number of logins allowed for the user.
^1 For limit.htm, send "s" if the user limit is not 1, send nothing if the user limit is 1.
^2 For limit.htm, send "are" if the user limit is not 1, send "is" if the user limit is 1.
badhost.htm In proxy by hostname, sent by EZproxy if someone uses a name that point at the EZproxy server but that EZproxy does not recognize. If this file does not exist, EZproxy redirects the user to the proper name of the EZproxy server, which is normally the preferred behavior.
cookie.htm Sent if EZproxy is unable to set its cookie in the remote browser.
https.htm Sent if someone tries to connect to an https service using htp
logout.htm Sent when someone accesses the /logout URL to stop an EZproxy session.
limit.htm Sent if the ::limit option is used in user.txt and a user exceeds his/her login limit. May include the special sequence ^0
logup.htm Sent if EZproxy is configured to use groups and a user tries to access a databases for which he/she is not authorized.
needhost.htm Sent if someone tries to use a starting point URL for a destination URL unknown to EZproxy.
ms.htm              Sent if the MaxSessions limit has been exceeded and is preventing access to a web page.
mv.htm Sent if the MaxVirtualHosts limit has been exceeded and is preventing access to a web page.
reject.htm Sent if a RejectIP line in config.txt matches the remote user address.