You can add data from one or several Bitbucket Data Center instances. For each instance, follow the instructions below.

Requirements

You can include data from Bitbucket Data Center under these conditions:

  1. The Bitbucket Data Center instance has to use HTTPS

  2. The Bitbucket Data Center has to be accessible from the public internet. Should the instance use a firewall, it has to allow traffic from the app’s backend to the Bitbucket instance.

Configuration in Bitbucket Data Center

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

Note that all Confluence users share this HTTP access token and view private repository content the Bitbucket Data Center user has access to.

We recommend using a user created specifically for the purpose of including data into Confluence Cloud through the macro. Avoid using an administrator Bitbucket user.

  1. Log into your Bitbucket Data Center with the user you want to use to access data from Confluence Cloud.

  2. Navigate to ‘Avatar on the Right Upper Corner’ → Manage Account → HTTP access tokens or Personal access tokens in older Bitbucket versions

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

    Create access token in Bitbucket screen

  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.

    Token creation completed screen

Configuration in Confluence Cloud

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

    Add Bitbucket DC instance screen

  2. Click Add.

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

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

    Enter URL and access token screen