How to avoid, Could not download page bundle, messages – Sonatype Support

Nexus Repository 2 officially sunsetted June 30, 2025. Visit my.sonatype.com for archived documentation. Migrate to Sonatype Nexus Repository 3 as soon as possible.

The Nexus Repository Outreach feature provides the content displayed on your Nexus Repository Welcome page. These are important messages coming direct from Sonatype. The Outreach feature is enabled by default.

Periodically your Nexus Repository instance will request a 'page bundle' of messages from Sonatype servers. The exact URLs that Nexus Repository uses to download the messages may change.

If there is a problem downloading these messages you may notice a nexus.log WARN message similar to the following:

admin com.sonatype.nexus.plugins.outreach.internal.outreach.SonatypeOutreach - Could not download page bundle

Avoiding 'Could not download page bundle' messages

The WARN log message will contain additional text that will help explain the root cause of the failure.

"connect timed out" or other socket-related errors

This implies that the socket connection that Nexus Repository is trying to establish to Sonatype servers is completely failing.

Options to resolve include:

adjust firewall software or HTTP proxy server to allow access to the remote host mentioned
when using an HTTP proxy server, and internet connections are still allowed without using it, possibly add the remote host mentioned as a "non-proxy" hostname in the Nexus Repository HTTP proxy settings
disable outreach feature

"PKIX path building failed"

Implies that Nexus Repository is able to connect to the mentioned remote host, but for some reason does not trust the SSL/TLS server certificate that is being returned:

Options to resolve include:

explicitly add the remote host mentioned ssl certificate to the Nexus Repository outbound certificate truststore
Nexus Repository 3 users should use the keytool method
override the URL in the Outreach capability to be a plain http:// URL, instead of the https:// URL
disable outreach feature

Remote Sites That Nexus Repository Outreach Feature May Connect With

Content for Outreach is only downloaded from Sonatype owned servers by your Nexus Repository instance. Web browsers using the Nexus Repository UI do not need to access these servers.

To prevent connection errors, requests to the following URLs should be allowed through your Nexus Repository firewall and the TLS server certificates should be trusted by Nexus Repository:

http://links.sonatype.com and https://links.sonatype.com
http://download.sonatype.com and https://download.sonatype.com
http://sonatype-download.global.ssl.fastly.net and https://sonatype-download.global.ssl.fastly.net

Depending on the version of Nexus Repository being used, the exact URLs used may vary.

As of 2.14.12 and 3.15.0, new installs come configured with https:// URLs:

How to Disable Outreach

Disabling this feature is a last resort.

You may decide to avoid receiving messages on your Nexus Repository welcome page entirely. Or you know that your Nexus Repository instance will never be able to have access to the required remote hosts.

In those cases, the outreach feature can be disabled.

Disabling Outreach in Nexus Repository 3

To disable outbound Outreach requests in Nexus Repository 3:

Sign in to your Nexus Repository instance as an Administrator.
Open Administration -> System -> Capabilities. Select the Outreach Management capability.
Click the Disable button. Your changes are immediately saved.

Disabling Outreach in Nexus Repository 2

To disable outbound Outreach requests in Nexus Repository 2:

Sign in to your Nexus Repository instance as an Administrator.
Open Administration -> Capabilities. Select the Outreach Management capability.
Uncheck the Enable checkbox. Click Save.