EZproxy Administration

Starting with EZproxy 2.2a GA (2003-08-02), EZproxy servers have a special administrative URL of the form:

http:// ezproxy.yourlib.org:2048/admin

The ability to access the /admin URL is limited to administrative users.

You can create an administrative user by editing user.txt and adding a line like:

rdoe: verysecret:admin

The :admin at the end of the line indicates that rdoe is an administrative user.

If your institution does not include a place to enter a password on your login form, then omit the password and use an unusual username, such as:


Once you have added the appropriate line to user.txt, you can go to the /admin URL of your server, log in, and then you should see a page of administrative options.

Glitch in EZproxy 3.6c and EZproxy 3.6d

EZproxy 3.6c and EZproxy 3.6d contain a bug that prevents the /admin URL from being directly accessible from ExcludeIP (on-site) addresses. If you are using one of these releases of EZproxy, you should access the normal login page such as:

http:// ezproxy.yourlib.org:2048/login

first and log into your administrative account, then after you have logged in, you can access:

http:// ezproxy.yourlib.org:2048/admin

Special Note for Athens, CAS, CGI and Shibboleth Authentication

If you are using an authentication method that redirects users to a different place for authentication, including Athens, CAS, CGI, and Shibboleth, logging in as an administrative user requires that you use a URL like this:

http:// ezproxy.yourlib.org:2048/login?user= rdoe&pass= verysecret

where you specify your administrative username and password as part of the /login URL. If you have to log in in this manner, limit the characters in your username and password to letters, digits, hyphens (-), underscores (_), and periods (.).

After you login, you can then access:

http:// ezproxy.yourlib.org:2048/admin

Older versions of EZproxy

Users with version of EZproxy prior to EZproxy 2.2a GA (2003-08-02) do not have the /admin URL, but they can use the information from this page to setup an administrative user on EZproxy and access EZproxy server status information. Once the account is established, you can use your normal login page to login to EZproxy as an administrative user, then go to a URL of the form:

http:// ezproxy.yourlib.org:2048/status

to view general status information for your EZproxy server.