This page last changed on Mar 20, 2007 by don.willis@atlassian.com.
Some of Confluence's macros, such as {rss} and {jiraissues} need to make web requests to remote servers in order to retrieve data. If Confluence is deployed within a datacentre or DMZ, it may not be able to access the Internet directly to make these requests. If you find that the {rss} macro does not work, ask your network administrator if Confluence needs to access the Internet through a web proxy.
Proxy support is configured by passing certain system properties to the Java Virtual Machine on startup. These properties are defined by Sun here: http://java.sun.com/j2se/1.4.2/docs/guide/net/properties.html
- http.proxyHost (default: <none>)
- http.proxyPort (default: 80 if http.proxyHost specified)
- http.nonProxyHosts (default: <none>)
http.proxyHost and http.proxyPort indicate the proxy server and port that the http protocol handler will use.
http.nonProxyHosts indicates the hosts which should be connected too directly and not through the proxy server. The value can be a list of hosts, each seperated by a |, and in addition a wildcard character (*) can be used for matching. For example: -Dhttp.nonProxyHosts="*.foo.com|localhost".
- http.proxyUser = username
- http.proxyPassword = secret
Reference: source
Please consult your application server documentation for how to provide system properties to the Java runtime, or to a particular application server. Some examples of how to start up different application servers with these system properties set are:
AppServer |
Startup script |
Variable to edit |
Example |
Orion |
n/a |
n/a |
java -Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128 orion.jar -userThreads |
Tomcat |
bin/catalina.sh, bin\catalina.bat |
JAVA_OPTS |
set JAVA_OPTS="-Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128" (Windows), or export JAVA_OPTS="-Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128" (Unix) |
Tomcat Service |
n/a |
n/a |
When using a sevice to start tomcat, JVM parameters must be set using special syntax. See Start Confluence automatically on Windows as a Service. |
Weblogic |
$BEA_HOME/domain/<domain>/startWebLogic.sh |
JAVA_OPTIONS |
export JAVA_OPTIONS="$JAVA_OPTIONS -Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128" |
JBoss 3.2.x |
bin/run.sh |
JAVA_OPTS |
export JAVA_OPTS="-Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128" |
Confluence does not currently support NTLM authentication, and can not identify itself to a proxy server in this way.
FWIW I had trouble with Tomcat on Windows (Confluence standalone) using the example above. Turns out the double quotes were not needed.
For me, the correct syntax for setting JAVA_OPTS was thus:
Hope this saves time & head-scratching.
Cheers,
Chris

Posted by doobya at Apr 06, 2006 08:56
|
AppServer |
Startup script |
Variable to edit |
Example |
WebSphere 5.1 |
n/a |
Applicatoin Server > Process Definition > JVM Arguments |
-Dhttp.proxyHost=proxy.example.com -Dhttp.proxyPort=3128 |

Posted by ricardo.sueiras@uk.pwc.com at May 08, 2006 17:55
|
Any idea whether you guys are planning to support NTLM authentication for this? Is there a Jira issue on which we can vote?

Posted by mircea_botez@yahoo.com at Jun 12, 2006 04:05
|
The relevant JIRA issue is CONF-5268. Unfortunately it's non-trivial to perform proper NTLM authentication from Java. Fortunately it's possible, but messy).

Posted by cmiller at Jun 12, 2006 05:28
|
Actually, there's a patch available for testing with the RSS macro on CONF-2326. I'd really like someone to try it out, so we can put it in a future release of Confluence.
Please comment on the issue if you get it working.

Posted by mryall at Jun 13, 2006 00:16
|
Not that I've tried it with Confluence but one might try using the NTLM proxy server available at http://apserver.sourceforge.net

Posted by skaze at Jun 21, 2006 08:00
|
The proposed way did not work for some reason for us. (confluence 226 intergrated with jira-3.6.3 standalone on windows) we had to add the settings to cataline.properties. See my comment on http://confluence.atlassian.com/x/TvMB

Posted by r.van.gijn@portinfolink.com at Aug 04, 2006 07:54
|
I've gotten this to work using the catalina.properties method for http.proxyPort and http.proxyHost, but Tomcat seems to completely ignore http.nonProxyHosts. Has anybody been able to get http.nonProxyHosts to work from within Confluence? I've searched around the web but can't seem to find any information on a Tomcat bug regarding this. Any suggestions?
As it stands now, I can either get external content to work within Confluence, or internal content; but not both.

Posted by rohrbaugh.k@pg.com at Nov 03, 2006 22:17
|
Issue CONF-5701 (http://jira.atlassian.com/browse/CONF-5701) points to a bug with not respecting nonProxyHosts for v2 RSS Macro. This should be a simple fix as it was previously fixed (change just needs to be carried over).

Posted by hill.ck@pg.com at Nov 06, 2006 16:54
|
If you're running Confluence as a Service, you'll need to set these option using the JvmOptions syntax as explained in Start Confluence automatically on Windows as a Service ... I missed that detail in the instructions above 

Posted by michaelmckeown at Mar 20, 2007 19:35
|
|