Configuring Marketplace connectivity

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Among other tasks, the UPM relies on an internet connection to perform the following functions for installed apps (also known as add-ons or plugins):

  • Search for and install new apps
  • Check for app version updates
  • Perform application upgrade checks

On this page:

If your Atlassian application does not have access to the internet, you can switch UPM to offline mode. In offline mode, features that rely on the connection are disabled. The following features remain available:

  • Manage existing apps
  • Upload an app 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.


What information UPM transmits to Atlassian Marketplace

To check for 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 or Manage apps page and expands the details view for an individual app, and
  • once every 24 hours, as a background task.

The information includes: 

  • The type and version of the currently running application 
  • The key and version of every installed app (e.g., "com.cheeseapp" "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 app or if a user requests an app. 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 new add-ons or Find new apps 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. 


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.

Firewall Rules

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:

  1. Click the Settings link at the bottom of the page.
  2. Uncheck the Connect to the Atlassian Marketplace checkbox. This option is enabled by default.
  3. Click Apply.

    The change will take effect immediately.

If you are on an older 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 or Find new apps 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". Follow the steps in our Setting properties and options on startup article for details.

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. 

Last modified on Nov 28, 2023

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.