Child pages
  • Mercurial Plugin
Skip to end of metadata
Go to start of metadata


Mercurial plugin


0.2.1, 2.0

Product Versions

1.2.2+, 2.0b8


Brett Adam











Subversion URL


Download JAR

For 1.2.x bamboo-hg-plugin-0.2.1.jar
For 2.0b8+ hg-2.0-SNAPSHOT.jar
For 2.2 hg-2.2-SNAPSHOT.jar

Download Source

For 1.2.x bamboo-hg-plugin-src-0.2.1.tar.gz
2.0 URL: source repository:

Conary Package

coming soon

NOTE: Cloned source tree to to better facilitate collaborative development.



Mercurial repository integration for Bamboo


  1. Copy the appropriate jar file into your <BAMBOO_HOME>/webapp/WEB-INF/lib directory and restart Bamboo
  2. In the configuration of your plan, there should be a new Mercurial option in the 'Repository Configuration' tab. Parameters are similiar to other repositories.
  3. That should be it.


Mercurial clone operation to populate the local copy requires that the directory into which the clone is being made NOT exist. However, Bamboo has already created the plan's build-dir before repo called. Hence, this plugin gets Mercurial to clone into a new hg/ subdirectory. The gotcha is that your Builder then needs to have hg/ set as your Working Directory.

SSH repository access is not yet supported. HTTP works just fine and should be adequate for most environments.

WebURL integration is only supported with the Bamboo 2.0 version. If you set up the Web Repository URL configuration when configuring your plan, two integrations are supported:

  1. the standard "Show details changes" where you can click to see each file diff in the change as well as view the whole file
  2. every changelog summary on the build summary page will have a clickable link to view the changeset on the web


JIRA Issues

type key summary assignee reporter priority status resolution created updated due

Data cannot be retrieved due to an unexpected error.

View these issues in Jira

Version History





2 September 2009

Dmitriy Akishin updated code for Bamboo 2.2. and provided new jar


6 August 2009

Cloned source tree to for better collaboration


4 April 2008

Initial release for Bamboo 2.0b8


6 September 2007

Fixed off-by-one bug in changelog reporting


30 August 2007

initial version

  • No labels


  1. Great stuff Brett!

  2. There's a few improvements I've made recently that I'll try to publish via subversion over Christmas

  3. So, I have updated this for Bamboo 2.0b8 and it seems to be working fine. Trying to get the source into the atlassian subversion repository...

  4. Source published to subversion repo

  5. I'm getting the following error when trying to checkout code:

    java.lang.NoSuchMethodError: com.atlassian.bamboo.command.Command.executeCommand(Lcom/atlassian/bamboo/command/CommandExecuteStreamHandler;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/util/Map;Lcom/atlassian/bamboo/v2/build/agent/capability/ReadOnlyCapabilitySet;)I
    at com.rpath.bamboo.plugins.repository.AbstractMercurialCommand.executeCommand(
    at com.rpath.bamboo.plugins.repository.AbstractMercurialCommand.executeCommand(
    at com.rpath.bamboo.plugins.repository.MercurialRepository.retrieveSourceCode(

    This is only a problem with Bamboo 2.2 (Bamboo 2.1.4 works fine).

    Has there perhaps been a change to the APIs which has broken this plugin?

    Thanks in advance!

    1. The code hasn't been updated for 2.2 yet. Hopefully, someone else has some time to do this soon!

  6. Dmitriy Akishin has apparently cracked the nut on Bamboo 2.2 migration for this plugin.

    I've cloned the source tree to to facilitate easier collaboration. Once I know that his changes are up there, I'll pull them across to the Atlassian hosted svn repo as well.