Installation

Owned by Michael Rüegg
Last updated: Oct 03, 2024 by antoine.doeraene
1 min read

Installing Repository Templates for Bitbucket directly from Atlassian Marketplace

  1. Click the admin drop-down on your Bitbucket Server instance and choose Add-ons.

  2. Click Find new add-ons from the left-hand side of the page.

  3. Locate Repository Templates for Bitbucket Server via search.

  4. Click Install to download and install Repository Templates for Bitbucket Server.

  5. You're done!

Installing Repository Templates for Bitbucket by file upload

  1. Download Repository Templates for Bitbucket Server on the Atlassian Marketplace (Details Tab, click the download button).

  2. Click the admin drop-down on your Bitbucket Server instance and choose Add-ons.

  3. Click Manage Add-ons...

  4. Click the Upload add-on link at the top right side of the page. 

  5. Enter the location of the JAR file you downloaded.

  6. Click Upload.

  7. You're done!

Extra requirement for Repository Templates 4.0.1 and 4.1.0 with Bitbucket 9 / Java 17

When using Repository Templates for Bitbucket 4.0.1 and 4.1.0 on Java 17 (required by Bitbucket 9), a JVM flag is required.

This requirement has been removed for Repository Templates 4.2.0 onwards, and we recommend to directly upgrade.

Add `--add-opens=java.base/java.lang.reflect=ALL-UNNAMED` to the JVM_SUPPORT_RECOMMENDED_ARGS environment flags of Bitbucket:

  1. Navigate to your Bitbucket installation, like`/opt/atlassian/bitbucket/current/bin`

  2. Edit the _start-webapp.sh file

  3. Note the #JVM_SUPPORT_RECOMMENDED_ARGS=line. Remove the # in front of it and add `--add-opens=java.base/java.lang.reflect=ALL-UNNAMED`

  4. Restart Bitbucket

Alternative: Define the value of the JVM_SUPPORT_RECOMMENDED_ARGS in your service manager, like in the Systemd unit definition, Docker container, etc.