Wiki source code of Configure XWiki to Use a Proxy Server
Last modified by Eleni Cojocariu-testing account on 2026/08/21 17:09
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | This procedure adds the proxy properties XWiki needs to the process that runs it; [[XWiki Behind a Proxy Server>>doc:documentation.xs.admin.installation.troubleshooting.xwiki-proxy-server.WebHome]] describes what fails without them. | ||
| 2 | |||
| 3 | 1. Open the startup file in which your installation sets the Java options:((( | ||
| 4 | |=Installation|=File|=Variable | ||
| 5 | |On a [[servlet container>>doc:documentation.xs.admin.installation.methods.install-xwiki-war.configure-servlet-container.WebHome]] such as Tomcat|##bin/setenv.sh## on Linux or ##bin/setenv.bat## on Windows, in the container's directory|##CATALINA_OPTS## | ||
| 6 | |As a [[standalone (demo) distribution>>doc:documentation.xs.admin.installation.methods.install-standalone-demo-distribution.WebHome]]|##start_xwiki.sh## on Linux or ##start_xwiki.bat## on Windows|##XWIKI_OPTS## | ||
| 7 | ))) | ||
| 8 | 1. Add the four proxy properties to that variable, with the host name and the port of your own proxy server:((( | ||
| 9 | {{code language="bash"}} | ||
| 10 | CATALINA_OPTS="$CATALINA_OPTS -Dhttp.proxyHost=proxy.mycompany.com -Dhttp.proxyPort=7777 -Dhttps.proxyHost=proxy.mycompany.com -Dhttps.proxyPort=7777" | ||
| 11 | {{/code}} | ||
| 12 | On Windows the same line reads: | ||
| 13 | {{code language="bat"}} | ||
| 14 | set CATALINA_OPTS=%CATALINA_OPTS% -Dhttp.proxyHost=proxy.mycompany.com -Dhttp.proxyPort=7777 -Dhttps.proxyHost=proxy.mycompany.com -Dhttps.proxyPort=7777 | ||
| 15 | {{/code}} | ||
| 16 | ))) | ||
| 17 | 1. Add ##-Dhttp.nonProxyHosts## to the same variable when some hosts must be reached directly, with the exceptions separated by vertical bars. | ||
| 18 | 1. Restart XWiki, and confirm that the properties reached its Java process, whose command line now carries them:((( | ||
| 19 | {{code language="none"}} | ||
| 20 | $ ps -ww -C java -o args= | ||
| 21 | java ... -Dhttp.proxyHost=proxy.mycompany.com -Dhttp.proxyPort=7777 -Dhttps.proxyHost=proxy.mycompany.com -Dhttps.proxyPort=7777 ... | ||
| 22 | {{/code}} | ||
| 23 | ))) |
