How to start a XWiki Container with Proxy parameters

Help / Discuss
1

Hey xwiki community,

I want to create a docker container for xwiki with a proxy connection. How can I set the proxy in the docker run command that XWiki can connect to the internet through the proxy?
Thanks for your help already!

Kind regards
Dennis

2

Hello, do you mean setting up a proxy server in front of an XWiki instance, as in https://www.xwiki.org/xwiki/bin/view/Documentation/AdminGuide/Installation/#HHTTPProxy ?

Or do you mean passing -Dhttp.proxyHost= -Dhttp.proxyPort= system parameters to the Servlet container JVM?

3

If it’s this then xwiki-docker/README.md at master · xwiki/xwiki-docker · GitHub should answer your needs.

If you need some Tomcat config changes, see xwiki-docker/README.md at master · xwiki/xwiki-docker · GitHub

Hope it helps

1 Like
4

Hi Vincent,

thank you for your quick answers!
I’ve got what I wanted with this environment parameter:

-e JAVA_OPTS="-Dhttp.proxyHost=<ProxyIP> -Dhttp.proxyPort=<ProxyPort> -Dhttps.proxyHost=<ProxyIP> -Dhttps.proxyPort=<ProxyPort>"

Kind regards
Dennis

5

It would be very great if these proxy settings could be configured in an other config file than the start.sh of xwiki. Currently with each update the proxy config has to be done again.

6

This is not really related to XWiki. You need to check your app server’s doc to understand how to configure it. XWiki just runs inside it as a webapp.

That said, I think you could edit /usr/local/tomcat/bin/setenv.sh.

We provide some default values in it as part of the docker image for Tomcat:

7

Hi Vincent, sorry I wasn’t completely paying attention to this being a docker related thread.
My comment was more about Debian package with XJetty. As the XJetty start sh is overwritten during each update the proxy configuration in that is overwritten each time.

9

I ran into something similar before, and setting the proxy variables in the environment section of the Docker run command worked fine. I used HTTP_PROXY and HTTPS_PROXY for simple needs. If you’re using Rotating proxies, just make sure the container trusts the proxy’s cert if it’s custom. Also, sometimes you need to pass those same proxy env vars to the JVM through JAVA_OPTS.