Skip to main content Skip to complementary content

Configuring Tomcat to use a proxy server

Procedure

  1. Stop your Tomcat server.
  2. Set the configuration. The configuration file is <TomcatPath>/bin/setenv.sh. If the file does not exist, create it.
  3. Add the following parameters, changing the parameters to match with your configuration:
    CATALINA_OPTS=$CATALINA_OPTS -Dhttp.proxyHost=proxy.server.com # Specify the host name or IP address of your HTTP proxy server. You can use this parameter for http and https host names.
    CATALINA_OPTS=$CATALINA_OPTS -Dhttp.proxyPort=YourHttpProxyPort # Specify the port number of your proxy server.
    CATALINA_OPTS=$CATALINA_OPTS -Dhttp.nonProxyHosts="localhost|host.mydomain.com|192.168.0.1" # Specify a list of hosts separated by "|" that do not require access through your proxy server.
    For example:
    CATALINA_OPTS=$CATALINA_OPTS -Dhttp.proxyHost=proxy.server.com 
    CATALINA_OPTS=$CATALINA_OPTS -Dhttp.proxyPort=3128
    CATALINA_OPTS=$CATALINA_OPTS -Dhttp.nonProxyHosts="localhost|host.mydomain.com|192.168.0.1"
    In case you use a proxy with authentication, go to <tomcat_path>/WEB-INF/classes/configuration.properties file and uncomment the following lines:
    • proxy with the HTTP protocol:
      #http.proxyUser=someuser
      #http.proxyPassword=somepassword
    • proxy with the HTTPS protocol:
      #https.proxyUser=someuser
      #https.proxyPassword=somepassword
    For more information about proxy configuration, see https://docs.oracle.com/javase/8/docs/technotes/guides/net/proxies.html.
  4. Restart your Tomcat server.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!