Manage add-ons - An unexpected error has occurred. Please refer to the logs for more information.

Troubleshooting Installation

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community


  1. You cannot access the Universal Plugin Manager from "Administration -> Manage add-ons" link.
  2. You may receive an error and see the following screen: 

    An unexpected error has occurred. Please refer to the logs for more information.



There are a few potential causes:

1) Configuration

a. The most common problem is that your server base URL does not match the actual URL of the site.

b. Incorrect or missing proxy settings in your server.xml when accessing Stash behind a proxy.

c. Incorrect plugin loading order causing UPM to fail to initialize properly when Stash is started.


2) UPM bug

a.  Unable to locate Jira server for this macro. It may be due to Application Link configuration.


1) Configuration

In matching order for the above listed causes:

a. Your server base URL needs to match the URL that you are using to access Stash. To change this setting, follow the Specifying the base URL for Stash document.

b. Your <STASH_INSTALL>/conf/server.xml must contain your proxy information in the Connector element according to what is described on the "Step 1" Integrating Stash with Apache HTTP Server

c. To correct the plugin loading order, follow the steps below:

  • Shut Stash down
  • Backup <STASH_HOME>/plugins directory
  • Remove the following directories. They will be rebuilt when Stash starts again.
    • <STASH_HOME>/plugins/.bundled-plugins/
    • <STASH_HOME>/plugins/.osgi-cache/
  • Restart Stash.

    Upon starting up, Stash will re-extract the required plugins from <STASH_INSTALL>/atlassian-stash/WEB-INF/classes/ and rebuild those plugin directories.

2) UPM bug

Upgrade your UPM.

Last modified on Feb 26, 2016

Was this helpful?

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