Debug Proxy Configuration

Last modified by Eleni Cojocariu on 2026/08/26 17:33

Content

Steps

Searching for an extension tells you whether XWiki reaches the Internet through the proxy server you configured; see XWiki Behind a Proxy Server for the cause it points at.

  1. Open the "Extensions" section of the wiki administration.

    administration-extensions-section.png

  2. Type the name of an extension in the search field.

    extension-search-field.png

  3. Click the search button.
  4. Read the result: the extensions listed were fetched from the remote repositories, so XWiki reaches them through the proxy server.

    extension-search-results.png

FAQ

The search lists nothing, or reports an error naming a repository. What does that mean?

The connection did not go through: either the proxy properties never reached XWiki, or the proxy server does not allow that host. Re-check the proxy configuration, then the host list the repositories need.

How do I see every property and environment variable the running XWiki reads?

The command line shows what the startup script passes, which is not always what the Java runtime ends up with, so it is worth reading the values from inside XWiki. Put the following in a page, which takes programming rights:

{{groovy}}
println "== Environment Variables =="
System.getenv().each { name, value -> println "Name: {{{$name}}} = Value {{{$value}}}" }
println ""
println "== Java System Properties =="
System.getProperties().each { name, value -> println "Name: {{{$name}}} = Value {{{$value}}}" }
{{/groovy}}

Get Connected