Bitbucket Server#

Follow the instructions below to set up the Codacy Self-hosted integration with Bitbucket Server.

Create a Bitbucket Server application link#

To integrate Codacy with Bitbucket Server, you must create an application link on your Bitbucket Server instance:

Create a key pair to sign and validate the requests between Codacy and the Bitbucket Server instance.

Run the following command to create the key pair using the RSA algorithm in the PKCS#8 format:
```
bash <(curl -fsSL https://raw.githubusercontent.com/codacy/chart/master/docs/configuration/integrations/generate-bitbucket-server-secrets.sh)
```
Store the keys in a safe place for usage in the next steps and as a backup.
Open <bitbucket server url>/plugins/servlet/applinks/listApplicationLinks, where <bitbucket server url> is the URL of your Bitbucket Server instance.
Create a new application link with the URL of your Codacy instance.

Important

If you're using Bitbucket Server 7.20 or later you must select the application type Atlassian product while creating the new application link.

This forces the integration to use OAuth 1.0 and is necessary to ensure the compatibility between Codacy and older versions of Bitbucket that only supported OAuth 1.0.

If Bitbucket Server may warn you that there was no response from the URL you entered. This is expected, and you can click Continue after verifying that the URL is correct.
Fill in the fields:
- Application Name: Name of the application. For example, Codacy.
- Application Type: Select Generic Application.
The remaining fields should be left blank.
After creating the new application link, click Edit to add an incoming authentication.
Fill in the fields of the incoming authentication:
- Consumer Key: Enter the consumerKey generated previously.
- Consumer Name: Name of the consumer. For example, Codacy.
- Public Key: Enter the consumerPublicKey generated previously.
The remaining fields should be left blank.

Configure Bitbucket Server on Codacy#

After creating the Bitbucket Server application link, you must configure it on Codacy:

Edit the file values-production.yaml that you used to install Codacy.

Set global.bitbucketEnterprise.enabled: "true" and define the remaining values as described below and with the information obtained when you created the Bitbucket Server application link:

bitbucketEnterprise:
  enabled: "true"
  login: "true" # Show login button for Bitbucket Server
  hostname: "bitbucket.example.com" # Hostname of your Bitbucket Server instance
  protocol: "https" # Protocol of your Bitbucket Server instance
  port: 7990 # Port of your Bitbucket Server instance
  consumerKey: "" # Generated when creating the Bitbucket Server application link
  consumerPublicKey: "" # Generated when creating the Bitbucket Server application link
  consumerPrivateKey: "" # Generated when creating the Bitbucket Server application link
  contextPath: "" # Context path of your Bitbucket Server, if configured

Apply the new configuration by performing a Helm upgrade. To do so execute the command used to install Codacy:

Important

If you're using MicroK8s you must use the file values-microk8s.yaml together with the file values-production.yaml.

To do this, uncomment the last line before running the helm upgrade command below.
```
helm upgrade (...options used to install Codacy...) \
             --version 12.0.0 \
             --values values-production.yaml \
             # --values values-microk8s.yaml
```

After this is done you will be able to use Bitbucket Server to authenticate to Codacy.

Share your feedback 📢

Did this page help you?

Thanks for the feedback! Is there anything else you'd like to tell us about this page?

255 characters left

We're sorry to hear that. Please let us know what we can improve:

255 characters left

Alternatively, you can create a more detailed issue on our GitHub repository.

Thanks for helping improve the Codacy documentation.

If you have a question or need help please contact support@codacy.com.

Last modified May 25, 2023