Where is the right place to put the plugin jar file?

I developed a plugin for Bamboo.

I put the jar file under the [Bamboo Inst Dir]/webapp/WEB-INF/lib and the plugin works fine.

But I wonder where the right place is.

There is the directory of [Bamboo Home]/plugins.

Which is the right place and what is the difference between them?

2 answers

1 accepted

2 votes

I may be wrong, but I think WEB-INF/lib location is for plugins 1 only. $BAMBOO_HOME/plugins is for both plugin 1 and plugin 2 (when manually installed). Put it into /plugins - in this way it will survive reinstallations.

You should use the Universal Plugin Manager (Admin > Administration > System > Plugins) to install plugin in Bamboo.


If you still want to install them manually, put them in $BAMBOO_HOME/plugins

Thank you for your info.

I tried to install my plugin using UPM, but it siad, "The plugin is a version 1 plugin. Version 1 plugins cannot be dynamically installed."

I refered to UPM Document. But it does not describe about the error.

What should I do to my plugin jar file.

I guess I should edit the atlassian-plugin.xml.

Is it right?

If you are developping a new plugin, you should definitely used plugin version 2.

Unless you plan to use it on an older version of Bamboo (pre 3.3), where version 2 is not supported on agents.

Are you trying to install a downloaded plugin or is it yours?

If you are developping a new plugin, you should definitely use plugin version 2, if you can (Bamboo > 3.3 and compatible module types).



Thank you for your valuable information.

Based on your information, I tested my plugin on various versions of Bamboo.

The test results are as below.

1. Older versions of Bamboo than 3.2, including 3.2

Plugin Type: 1

atlassian-plugin.xml Root Symantec: <atlassian-plugin key="*" name="*">

Directory to place jar: [Bamboo Inst Dir]/webapp/WEB-INF/lib

2. Later versions of Bamboo than 3.4, including 3.4

Plugin Type: 2

atlassian-plugin.xml Root Symantec: <atlassian-plugin key="*" name="*" <tt>plugins-version="2"</tt>>

Directory to place jar: [Bamboo Home]/plugins

3. Bamboo 3.3

Both plugin types of 1 and 2 do not apply to the version 3.3.

The error message below appears when using plugin 1 or plugin 2.

[XWorkPluginConfigurationMaintainer] Error while reloading XWork configuration to include *.***Actions (null)
java.lang.NoClassDefFoundError: com/atlassian/bamboo/plan/cache/ImmutablePlan

I cannot configure a plugin for Bamboo 3.3.

Did you compile it against 3.3 sources?

Thank you for your advice. The issue has been solved.

Suggest an answer

Log in or Join to answer
Community showcase
Renan Battaglin
Published May 18, 2017 in Bamboo

FAQ: How to Upgrade Bamboo Server

Bamboo 5.9 will no longer be supported after June 12, 2017. What does this mean? As part of our End of Life policy, Atlassian supports major versions for two years after the first major iteratio...

1,097 views 0 5
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot