Managing add-ons

Redirection notice

This page will redirect to /display/BitbucketServer/Managing+add-ons .

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.

On this page:

About the Universal Plugin Manager (UPM)

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.

Administering add-ons in Stash 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 Stash, see Requesting add-ons.

Add-ons for Stash Data Center

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.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport