Does the forwarder support a proxy?

Yes, you can configure the Stairwell forwarder to operate in environments with a proxy.

Windows

You can configure the proxy either during installation, or by manually adding a registry value after installation.

The forwarder supports both unauthenticated and authenticated proxies. Use the following format for the proxy string:

http://[username:password@]<ip_address_or_hostname>:<port>

Examples:

Unauthenticated proxy: http://127.0.0.1:8888
Authenticated proxy: http://myuser:[email protected]:8888


Installing with the Proxy Argument

To configure the proxy during installation , pass the HTTPSPROXY command-line parameter to the installer.

.\\StairwellForwarderBundle.exe TOKEN="TOKENHERE" ENVIRONMENT_ID="ENVIRONMENTIDHERE" HTTPSPROXY="http://127.0.0.1:8081" /quiet /norestart /log C:\\stairwell.log


Adding the proxy configuration into the Windows registry

To set up a proxy for an existing forwarder, edit the Windows Registry and restart the forwarder service.

Registry Key

Forwarder Versions 1.6 and later and 1.4.x:
HKEY_LOCAL_MACHINE\SOFTWARE\Stairwell\SwellService

Forwarder Versions 1.3.x and earlier and 1.5.1:
HKEY_LOCAL_MACHINE\SOFTWARE\Stairwell\Inception

HttpsProxy Value

Add the following value to the appropriate registry key based on your forwarder version:

Value NameTypeData
HttpsProxyString (REG_SZ)e.g. http//127.0.0.1:8888


Removing Proxy Configuration from the Windows registry

To remove the proxy configuration, delete the HttpsProxy registry value and restart the service.

Registry Location:

Forwarder Versions 1.6 and later and 1.4.x:
HKEY_LOCAL_MACHINE\SOFTWARE\Stairwell\SwellService\HttpsProxy

Forwarder Versions 1.3.x and earlier and 1.5.1:
HKEY_LOCAL_MACHINE\SOFTWARE\Stairwell\Inception\HttpsProxy

Linux

Refer to the Linux installation guide for instructions on configuring the proxy.