Managing add-ons

An add-on is an installable component that supplements or enhances the functionality of Bitbucket Server in some way. For example, the Custom Navigation Plugin enables you to configure custom navigation tabs specific to a repository. Other add-ons are available for adding graphs to Bitbucket Server, importing SVN source control projects into Bitbucket Server, and accessing Atlassian support from Bitbucket Server.

Bitbucket Server comes with many pre-installed add-ons (called system add-ons). You can install more add-ons, either by acquiring the add-on from the Atlassian Marketplace or by uploading it from your file system. This means that you can install add-ons that you have developed yourself. For information about developing your own add-ons for Bitbucket Server, see the Bitbucket Server Developer Documentation.

On this page

About the Universal Plugin Manager (UPM)

You administer add-ons for Bitbucket Server using the Universal Plugin Manager (UPM). The UPM is itself an add-on that exposes add-on administration pages in the Bitbucket Server Administration Console. UPM works across Atlassian applications, providing a consistent interface for administering add-ons in Bitbucket Server, Crucible, Confluence, FishEye, JIRA applications, and Bamboo.

UPM comes pre-installed in recent versions of all Atlassian applications, so you do not normally need to install it yourself. However, like other add-ons, the UPM software is subject to regular software updates. Before administering add-ons in Bitbucket Server, therefore, you should verify your version of the UPM and update it if needed.

Administering add-ons in Bitbucket Server

You can update UPM, or any add-on, from the UPM's own add-on administration pages. Additionally, you can perform these tasks from the UPM administration pages:

  • Install or remove add-ons
  • Configure add-on settings
  • Discover and install new add-ons from the Atlassian Marketplace
  • Enable or disable add-ons and their component modules

It shows only those plugins that are supported in your version of the product, so that you do not install incompatible plugins.

If the add-on request feature is enabled in your Atlassian application, non-administrative users can also discover add-ons on the Atlassian Marketplace. Instead of installing the add-ons, however, these users have the option of requesting the add-ons from you, the administrator of the Atlassian application.

For more information on administering the add-on request feature or performing other common add-on administration tasks, see the Universal Plugin Manager documentation. For an end-user's view of requesting add-ons in Bitbucket Server, see Requesting add-ons.

Add-ons for Bitbucket Data Center

Installing, and managing, add-ons for Bitbucket Data Center is done in the same way as for Bitbucket Server, as described above. The only requirement is that the add-on is Data Center-compatible – see Bitbucket Data Center Add-ons for compatibility information.

You can install an add-on from any cluster node. The add-on is stored on the shared file system for the Bitbucket Data Center, and made available to all nodes in the cluster.


Last modified on Feb 6, 2019

Was this helpful?

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