Configuring Marketplace Connectivity
Among other tasks, the UPM relies on an internet connection to perform these functions:
- Search for and install new add-ons
- Check for add-on version updates
- Perform application upgrade checks
In some deployments, the Atlassian application operate without access to the internet. To accommodate this, you can switch UPM to offline mode. In offline mode, UPM does not connect to the internet, and features that rely on the connection are disabled in the UPM interface. However, the following features remain available:
- Managing existing add-ons
- Uploading an add-on JAR from a local server
- Audit logging
For deployments protected by a firewall, you can configure the firewall to permit connections between UPM and the remote servers it uses, as described below.
See Problems connecting to the Atlassian Marketplace for information about troubleshooting network connection problems.
On this page:
What information UPM transmits to Atlassian Marketplace
To check for add-on updates and perform other functions, UPM collects and sends information to Atlassian Marketplace. It also collects and transmits information for analytics purposes.
UPM transmits this information whenever an administrator visits the 'Manage Add-ons' page and expands the details view for an individual add-on (from the installed list or the find add-ons page). In addition, a background task that runs every 24 hours sends the same information.
The information includes:
- The type and version of the currently running application (e.g., JIRA 5.1)
- The add-on key and version of every installed add-on (e.g., "com.zenfoundation" "1.0")
- The UPM version
You can suppress the transmission of this information by switching UPM to offline mode.
If analytic information collection is enabled, the following information is also sent to Marketplace:
- Support Entitlement Number and Server ID (from the app license)
- The maximum number of users for the license
- The application license type (such as an evaluation license)
In addition, UPM sends analytics information for certain usage events, for example, if you uninstall an add-on or if a user requests an add-on. Optionally, you can disable the transmission of analytics information.
Configuring your firewall for UPM connectivity
When you open a page for administering add-ons, such as the 'Find Add-ons' page, the UPM attempts to contact the Marketplace website. If it cannot connect to Marketplace due to a firewall or other network connection issue, it displays the following message:
The Atlassian Marketplace server is not reachable. To avoid problems when loading this page, you can disable the connection to the Marketplace server. Click here for more information...
To have certain UPM features function properly, you may need to modify your firewall configuration. In particular, you need to permit TCP connections between UPM and external servers.
Since IP addresses for a given domain can change over time, Atlassian recommends that you configure your firewall policy by hostname rather than by numeric IP address. If you do need to configure rules by IP address, we suggest that you use a network analysis tool to investigate outgoing connections made by UPM. And keep in mind that you may need to update the rules on occasion, in this case.
To allow UPM to perform online functions behind a firewall, you need to set up firewall whitelist rules that enable UPM to connect on port 443 to these servers:
- *.atlassian.com: UPM connects to several servers in the atlassian.com domain, including marketplace.atlassian.com, marketplace-cdn.atlassian.com, id.atlassian.com, maven.atlassian.com, and others.
- *.cloudfront.net: certain Marketplace assets (screenshots, logos etc) are hosted on cloudfront. Calls to that domain are expected.
Switching UPM to offline mode
To disable the UPM connection to the Marketplace:
- Click the Settings link at the bottom of the page.
- Clear the Connect to the Atlassian Marketplace checkbox. This option is enabled by default.
- Click Apply.
The change takes effect immediately and the Manage Add-ons page appears.
If you are on a previous version of the Universal Plugin Manager you may not have this option in the UPM. If that is the case, follow the instructions in Problems Connecting to the Atlassian Plugin Exchange to disable the connection.
In offline mode, features that rely on Internet connectivity, such as the 'Find New Add-ons' page are hidden from the user interface.
Disabling analytics information sharing
Atlassian collects license-related analytics information based on usage events in the add-on administration pages. You can disable the transmission of analytic data by setting the Java system property for disabling data transmission. The setting is "atlassian.upm.server.data.disable=true".
This setting disables only the transmission of license information. Other UPM features that rely on communication with the Marketplace will continue to work. Optionally, you can disable this type of information as well.
For details on how to set system properties for your application, see the documentation for that application.