Mercurial repositories no longer work on Bamboo 8 or newer: Cannot use this repository. Plugin is missing or disabled.

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

After upgrading to Bamboo 8.0 or newer, the Mercurial repositories no longer work: Cannot use this repository. Plugin is missing or disabled.

Environment

Bamboo 8 or newer.

Diagnosis

The following error shows up when accessing a Mercurial repository in Bamboo after upgrading to 8.0 or newer.

1 Cannot use this repository. Plugin is missing or disabled. Plugin key: com.atlassian.bamboo.plugins.atlassian-bamboo-plugin-mercurial:mercurial

Under Bamboo administration > Overview > Server Capabilities, system.hg.executable is marked as a custom capability and there it's not possible to add a Mercurial capability type.

Cause

Starting on Bamboo 8.0, support for Mercurial has beendiscontinued and the Mercurial plugin was removed from bundled plugins.

Solution

Repositories can be re-added with the Git repository type. It's also strongly suggested to Migrate to Git.

Updated on March 17, 2025

Still need help?

The Atlassian Community is here for you.