Git operation fails with error JGit implementation does not support merging or tagging

Still need help?

The Atlassian Community is here for you.

Ask the community


This KB article is applicable for all Bamboo versions before 7.1. JGit is deprecated since Bamboo 6.8 as announced here and has been fully removed in Bamboo 7.1.


Git checkout task fails with the following error in atlassian-bamboo.log:

java.lang.RuntimeException: java.lang.UnsupportedOperationException: JGit implementation does not support merging, please use native Git

Repository Tag task fails with the following error in atlassian-bamboo.log

Repository Tag task fails: java.lang.UnsupportedOperationException: Creating tags is not supported with JGit, please use native Git instead


JGit is a Java library bundled with Bamboo that interacts with Git repositories when there is no native Git binary installed on the server and defined as a Server Capability. The bundled JGit isn't as feature rich or as performant and thus does not support Git merge or tagging.


To use native Git instead of jGit, please do the following:

  1. Install a Git binary on the Bamboo server and any remote agents that will need to use it.
  2. Define it as a Server Capability at Bamboo Administration > Overview > Server Capabilities
  3. For agents, you may verify if you have Git capability configured under their respective capabilities section as explained here: Configuring capabilities

DescriptionGit checkout fails with JGit implementation does not support merging

Last modified on May 13, 2020

Was this helpful?

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