Bitbucket Integration

The Nx Cloud + Bitbucket Integration lets you access the result of every run—with all its logs and build insights—straight from your PR.

Using an App Password

If you are using BitBucket Cloud (bitbucket.org) and are not self-hosting it, you can enable an "app password" for authentication.

The minimum required permissions are write access to PRs:

Once the app password is created, save it in a secure location and then head back to your workspace settings on NxCloud and let's set up a BitBucket integration:

1. Fill-in all the required fields for selecting your Bitbucket repository
2. Username is found on the account settings screen (it is not your email address)
3. Paste your app password created earlier into the Access Token box
4. That's it!

Using an HTTP Access Tokens

If you are using BitBucket Data Center (on-prem) you need to enable "HTTP Access Tokens" for authentication.

User linked access tokens

Due to the type of APIs NxCloud needs to call, we need to create an access at the user level. Repo level access tokens will not work.

The minimum required permissions are write access to the repository:

Once the token is created, save it in a secure location and then head back to your workspace settings on NxCloud and let's set up a BitBucket integration:

1. Fill-in all the required fields for selecting your Bitbucket repository
2. Username is found on the account settings screen (it is not your email address)
3. Paste your access token created earlier into the Access Token box
4. Make sure you give NxCloud the URL of your BitBucket instance (this can be in the simple form of https://your-bitbucket-instance.com)
5. That's it!