Skip to main content
Skip table of contents

Connect to Bitbucket Data Center ☁️

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


To include data from Bitbucket Data Center, it must fulfill these requirements:

  1. It must be reachable via a public DNS entry and IP.

  2. It must use HTTPS.

  3. The HTTPS certificate must be valid. Self signed certificates or certificates signed by your own root certificate authority are not accepted.

  4. The firewall has to allow traffic from the public internet. Or you can choose to use a static IP, so you can white list the IPs in the firewall. The Static IPs are, When using the static IP, QuotaGuard is used with its privacy and security policy.

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. If your Bitbucket DC instance is behind a firewall, you use the ‘Static IP’ option to allow list the app. The IP’s used in this case are, With the static IP, traffic will be routed via QuotaGuard and it’s privacy and security policy applies.

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

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.