[Other doc versions]
An add-on is an installable component that supplements or enhances the functionality of Stash 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 Stash, importing SVN source control projects into Stash, and accessing Atlassian support from Stash.
Stash 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 Stash, see the Stash Developer Documentation.
You administer add-ons for Stash using the Universal Plugin Manager (UPM). The UPM is itself an add-on that exposes add-on administration pages in the Stash Administration Console. UPM works across Atlassian applications, providing a consistent interface for administering add-ons in Stash, Crucible, Confluence, FishEye, JIRA 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 Stash, therefore, you should verify your version of the UPM and update it if needed.
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:
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 Stash, see Requesting add-ons.
Installing, and managing, add-ons for Stash Data Center is done in the same way as for Stash 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 Stash Data Center, and made available to all nodes in the cluster.