LoginPort

Why Is This Important?

LoginPort allows you to specify a particular port for EZproxy to use to identify itself and additional ports that it should use to listen for requests. This can be helpful in configuring EZproxy to Proxy by Hostname or Proxy by Port, migrating a server using one port to another port, and setting up EZproxy to work with your firewall address translation.

Ports beneath 1024 are privileged ports, and EZproxy is set to run by default on port 2048. These well-known ports require privileged users to bind to them. We do not recommend running EZproxy as a privileged user. On Linux and Solaris, root is a privileged user.

If you have to use a well known port, please use RunAs User and RunAs Group directives to change your port.

LoginPort is a position-dependent config.txt that specifies the port(s) on which EZproxy should listen for incoming login, menu, and administration requests using http.

The first LoginPort directive establishes the port that EZproxy will use when generating URLs that point to itself using http. Subsequent LoginPort directives establish additional ports on which EZproxy should listen for http requests.

The basic construction for this directive is as follows:

LoginPort 80

This configures EZproxy to listen on the standard http web server port 80.

By default, EZproxy listens on all IP interfaces. If the Interface directive is employed before LoginPort, then EZproxy will only attempt to listen on the specified interface and port.

On Linux and Solaris, if port is below 1024 and -Virtual is not specified, then EZproxy must be started by the root user. In this instance, the RunAs directive can be used to direct EZproxy to change to a different user account once listening has been established on the specified port(s).

Qualifiers

Qualifier Description
port number The port on which EZproxy should listen for incoming http requests.

Options

Option Description
-Virtual Tells EZproxy not to actually listen on the port. When used, an additional LoginPort directive must follow to establish an actual port on which EZproxy should listen for requests.
 

To direct EZproxy to listen on the standard http web server port 80, enter the following directive statement in your config.txt file:

LoginPort 80

Migrating an EZproxy Server from an Existing Port to a New Port: Basic

If you would like to migrate an existing EZproxy server with URLs that point to port 2048 to start using port 80, enter the following directive statement in your config.txt file:

LoginPort 80
LoginPort 2048

The sequence of the LoginPort directives is crucial as EZproxy will generate any URLs that point to itself based on the first LoginPort directive.

Migrating an EZproxy Server from an Existing Port to a New Port: Advanced

If you add a second IP address to your server, you may need to migrate an existing EZproxy server with URLs that point to port 2048 to port 80 on a server that already has an existing web server using port 80. Enter the following configuration in your config.txt :

Interface 192.168.1.5
LoginPort 80

Interface Any
LoginPort 2048

Using a Virtual Port

If you need to configure EZproxy to act as though it is listening on port 80, but actually listen on port 8080, you can enter the following configuration in your config.txt :

LoginPort -Virtual 80
LoginPort 8080
 

The following directives interact with or control functions related to this directive:

FirstPort
Interface
LoginPortSSL
RunAs
 

This page last revised: August 7, 2015