Skip to main content
You can onboard using your own Bitbucket repository. If you would like to use your own Bitbucket repository, please complete the following steps:
1

Create a Bitbucket Repository

Create a new Bitbucket private repository using one of these options:
2

Configure allowed IP addresses

If you are restricting access to your Bitbucket workspace using IP addresses allow list, add the IP addresses displayed in the Bitbucket connection screen in Honeydew App settings page to the “IP Allow List” of your Bitbucket workspace.
For the Honeydew Cloud deployment, the following IP addresses are used:
  • 34.86.209.90
  • 34.145.147.92
If you are using a private Honeydew deployment, the IP addresses will be different. You can find them in the Bitbucket connection screen in Honeydew App settings page.
3

Set up Honeydew

Please reach out to support@honeydew.ai and send the full repository name - org-name/repository-name (e.g. honeydew-ai/honeydew-quickstart).
4

Create a Bitbucket Token

Create a new Bitbucket repository token for Honeydew integration:
  • In Bitbucket, under the repository you have created for Honeydew, go to Repository settings -> Access tokens
  • Create a new Repository access token. Set the Write permission under Pull requests: New Repository access token
5

Configure the token in Honeydew

In the Honeydew application, go to Settings -> Bitbucket and configure the token.
If you have branch restrictions for new repositories, you may need to relax these rules for the Honeydew Bitbucket repository. Specifically, please disable Merge checks requiring minimal number of approvals.
To validate semantic-layer changes in your CI/CD pipeline, see the CI/CD Overview.

​
Clean up merged branches

Honeydew creates a Pull Request when you publish changes, but does not delete the branch when that Pull Request is merged in Bitbucket. Set source branch deletion as the default so merged branches do not accumulate in the Honeydew branch list:
  1. In your repository, go to Repository settings -> Branching model (under Workflow)
  2. Set Delete source branch by default to On
The same setting can be applied to all repositories in a project from the project’s Branching model settings. See the Bitbucket documentation on configuring a project’s branching model for the current steps.
This sets the default for the merge dialog. Whoever merges can still clear the option, which leaves the branch in place.
See Branch cleanup after merge for how branch deletion affects the Honeydew branch list.