Skip to main content
OCLC Support


Learn how to use the Name config.txt directive to provide a host name in EZproxy.

Name is a position-independent directive that normally appears toward the top of config.txt. In the absence of a Name directive, EZproxy will take its hostname from the operating system. If multiple Name directives appear in config.txt, the last Name directives takes priority.

Name should be followed by the hostname of your EZproxy server. Ports used by EZproxy (e.g. :2048) should not be included.

The use of numeric hostnames is not recommended.

Determine what name EZproxy is calling itself

During startup, EZproxy records a message similar to this to messages.txt:

Server name

Since this line appears after every startup of EZproxy, you should locate the last such line in messages.txt to determine the name EZproxy is currently using.

Avoid the use of underscore (_) in hostnames

Internet Explorer will block EZproxy's cookie if your hostname contains an underscore (_).

Naming for two-letter, international domain

When naming an EZproxy server for a two-letter, international domain, the EZproxy server name should contains at least four hostname components (e.g. ezproxy.library.yourlib.xy). Using only two hostname components will always fail.

When using Internet Explorer with only three hostname components, Internet Explorer may block the cookie if the domain is short (e.g., library.ab.xy). When this occurs, there is no work-around other than renaming the server to use four hostname components.

When using Safari 2.0 and later with only three hostname components, Safari defaults to blocking the cookie. With EZproxy 3.6c GA (2006-03-10) or later, you can add add the following to config.txt to work around this Safari restriction:

Option SafariCookiePatch
Naming for all other domains

For all other domains, a minimum of three hostname components are required (e.g., is invalid, and are valid).

Blocked cookie error page

If these guidelines for naming your EZproxy server are not followed, you may still be able to see the login page, but once you enter a valid username and password, EZproxy will present a page about its cookie being blocked.

DNS requirements 

Simply choosing a name for your EZproxy server and adding a Name directive to config.txt is not enough to allow the name to be used. In addition, you must coordinate with your network administrator to have the name registered in your Domain Name Server (DNS). Attempting to use a name that is not registered will lead to page not found errors.



Related directives 

FirstPort, LoginPort, LoginPortSSL