Proxy Configuration

If your DSpace instance must access the internet through a proxy server (e.g., to connect to external services like CrossRef, PubMed, ORCID, etc.), you need to configure the proxy settings in the dspace.cfgl.

📁 Where to Configure

The proxy configuration settings are located in the dspace.cfg file

You can override these settings in your local.cfg depending on your setup.

🌐 Required Settings

Here are the main proxy-related properties you can configure. For the full reference please check: Configuration Reference#ProxySettings

1. Enable Proxy Support

useProxy = true

Set this to true to enable proxy support globally in DSpace. This property is already set as true by default

2. Set Proxy Host

http.proxy.host = <your.proxy.host>

Specify the hostname or IP address of your proxy server.

3. Set Proxy Port

http.proxy.port = <proxy port> 

Specify the port used by your proxy server.

4. Exclude specific hostnames from using the proxy

http.proxy.hosts-to-ignore = <proxy port> 

As mentioned above, the proxy configuration is applied globally. Some connections are excluded by default—for example, SOLR connections, which are expected to occur over a private network.

In some cases, due to external host requirements or other specific needs, you may want to disable or restrict the use of the proxy for certain hostnames. This is where the http.proxy.hosts-to-ignore property becomes useful.