XWiki Behind a Proxy Server

Last modified by Eleni Cojocariu-testing account on 2026/08/21 17:09

Explanation

An XWiki instance that reaches the Internet through a proxy server cannot search for or install extensions until that proxy is configured, because the Extension Manager fetches them from remote repositories. The log files then fill with connection refused exceptions.

Cause

XWiki makes its outgoing HTTP calls through Apache HttpClient, which reads the standard Java proxy system properties. Nothing sets those properties by default, so XWiki tries to open the connection directly and the network refuses it.

Solution

Configure XWiki to use the proxy server, then check that the configuration reached it.

FAQ

Why do some extensions fail to load when using a proxy that restricts Internet access?

The Extension Manager reads from three hosts, so a proxy that allows only some of them leaves part of the catalogue unavailable: store.xwiki.com, extensions.xwiki.org and nexus.xwiki.org. Note that the first is a .com and the other two are .org.

More

To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.

Related

Get Connected