(warning) This space has been archived and is not current (warning)

The latest documentation for Include Bitbucket for Confluence Cloud is available at Include Bitbucket for Confluence

Configuration to Access Bitbucket Data Center Repositories

You only have to do the following steps if you intend to include files from a Bitbucket Data Center. If you only use Bitbucket Cloud, you can ignore the following instructions.

Repeat these steps for every Bitbucket Data Center instance you want to access.

1. Requirements

  1. The Bitbucket Server or Data Center needs to be accessible via https on the public internet.

  2. You need admin permission on Confluence Cloud.

2. Configuration in Bitbucket Data Center

To access files from Bitbucket Data Center repositories, use a personal access token.

Note that all Confluence users share this personal access token and view private repository content the Bitbucket Data Center user has access to. Avoid using an adminstrator Bitbucket user. Think about using a specific user for this purpose.

  1. Log into your Bitbucket Data Center with the your you want to use.

  2. Navigate to ‘Avatar on the Right Upper Corner’ → Manage Account → Personal access tokens

  3. Create a new token. The default read permissions are enough. Save the token.

  4. Copy the generated token. You won’t be able to see it again. If you loose it you have to revoke and recreate the token.


3. Configuration in Confluence Cloud

  1. Go to Confluence Configuration → Include Bitbucket. You should then see the following page:

  2. Click Add.

  3. Add your Bitbucket Data Center URL and the personal access token. Then submit the configuration.

  4. Finished. Now you can include files from your Bitbucket Data Center/Server repositories.