Configure EZproxy to Run as a Windows Service

This example demonstrates how to configure EZproxy to run as a Windows service. Windows services are started when you power up your computer before anyone logs in, so this is the preferred method for production installations of EZproxy.

Before configuring EZproxy to run as a service, you must have already installed and configured EZproxy. See Install EZproxy for Windows for the installation steps that must be performed before you configure EZproxy to run as a service.

Please note that if you are also running IIS and EZproxy together on a single server, and if each is using a port 80 on separate IP addresses, then you must perform an additional step. See EZproxy/IIS Co-Existence on Port 80 for the required steps.

Opening a command prompt window on Windows Vista

On Windows Vista, you must open a command prompt window as an administrator to install or remove EZproxy as service.

To do this, click on Start, All Programs, Accessories, right-click Command Prompt, Run as administrator, and Continue.

Opening a command prompt window on other versions of Windows

Except for Vista, you can open a command prompt window by clicking on Start, Run, and in the Run window next to Open type:

cmd

and click OK.

Install service

To install EZproxy as a Windows service, open a command prompt, change your current directory to your EZproxy directory, issue the command:

ezproxy -si

and then you can start EZproxy running with the command:

net start ezproxy

If you receive error 1067 at this point, see Windows Error 1067 for steps to diagnose the problem.

Remove service

Regardless of how you install EZproxy as a Windows service, from a command prompt window, use the commands:

net stop ezproxy
ezproxy -sr

to remove EZproxy from running as a service.

Restart service

If you update config.txt/ezproxy.cfg, you need to restart the service. See Restarting EZproxy for information on how to restart EZproxy.

Historic note about -sw

If you installed an older version of EZproxy with the -sw option for IIS compatability and if you have followed the steps mentioned in EZproxy/IIS Co-Existence on Port 80 you can change back to the -si form with the commands:

net stop ezproxy
ezproxy -sr
ezproxy -si
net start ezproxy