Configure Proxy for Gateway Agent

Enable and Disable the Proxy

The proxy is enabled by default. To disable the proxy:

1. Open config/application.properties.
2. Find the following line: proxy.enabled=true.
3. Remove true and type false.
4. To enable the proxy, edit the value back to true.

Note: If the proxy is not explicitly configured in application.properties (for example, proxy.enabled=false or not set), the Gateway Agent automatically attempts to detect prox settings from your system environment.

Configure Proxy via application.properties

The proxy behavior is controlled in config/application.properties via proxy.type, which supports the following three options:

• proxy.type=system: Use the system proxy settings.
• proxy.type=static: Use a fixed proxy configuration.
• proxy.type=pac: Use a PAC file for proxy configuration.

Static Proxy Configuration

Note: Use this option if you have a traditional, fixed proxy server (hostname and port).

The following properties are required:

proxy.enabled=true
proxy.type=static
proxy.host=proxy.company.com
proxy.port=8080

If your proxy server requires a username and password, add the following properties, replacing the username and password values with your required values:

proxy.username=john.doe
proxy.password=secretpass

PAC Proxy Configuration

Note: Use this option if your organization provides a PAC file (Proxy Auto-Configuration) that tells clients the proxy to use for each destination.

The following properties are required:

proxy.enabled=true
proxy.type=pac
proxy.pac-url=http://proxy.company.com/proxy.pac

proxy.pac-url defines the location of the PAC file. The location can be one of the following formats:

• HTTP/HTTPS URL: For example, http://proxy.company.com/proxy.pac
• A local file URL: For example, file:///C:/config/proxy.pac or file:///etc/proxy/proxy.pac

If your proxy server requires a username and password, add the following properties, replacing the username and password values with your required values:

proxy.username=john.doe
proxy.password=secretpass

System Proxy Configuration

This method is not recommended. There are 2 options to set system properties:

Option 1: Setting System Properties

Use the following command to pass system properties directly to the Java process when starting the Gateway Agent:

java -Dhttps.proxyHost=proxy.company.com -Dhttps.proxyPort=8443 -jar agent-server.jar

or use the following HTTP:

java -Dhttp.proxyHost=proxy.company.com -Dhttp.proxyPort=8080 -jar agent-server.jar

Option 2: Setting Environment Variables

Use the following commands for Linux or Mac:

export HTTPS_PROXY="http://proxy.company.com:8080"
# or
export HTTP_PROXY="http://proxy.company.com:8080"
java -jar agent-server.jar

Use the following commands for Windows (PowerShell):

$env:HTTPS_PROXY = "http://proxy.company.com:8080"
java -jar agent-server.jar

Restart Gateway Agent
If the proxy is set via config/application.properties, restart the Gateway Agent and check if the process reads the configuration exactly. The logs should be the following:

2026-01-28 06:58:52 [main] INFO  c.s.g.agent.config.OkHttpConfig - SSL configured to trust all certificates.
2026-01-28 06:58:52 [main] INFO  c.s.g.a.config.ProxyResolverService - Loading PAC file from: file:///C:/Users/Administrator/Downloads/pac.pac
2026-01-28 06:58:52 [main] INFO  c.s.g.a.config.ProxyResolverService - Successfully initialized PAC proxy resolver
2026-01-28 06:58:52 [main] INFO  c.s.g.agent.config.OkHttpConfig - Configured proxy authentication for user: myUser
2026-01-28 06:58:52 [main] INFO  c.s.g.agent.config.OkHttpConfig - Configured PAC-based proxy from: file:///C:/Users/Administrator/Downloads/pac.pac