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.