Visit my.sonatype.com for documentation on Nexus Repository version 2.
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 theOutreach 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 theOutreach Management
capability. - Uncheck the
Enable
checkbox. ClickSave
.