Below is a step by step guide on how to get started with BitBucket Server. If your repositories are behind a firewall, please allowlist our IPs on port 443 over HTTPS. You also need a public DNS record pointing to the IP address that is being exposed for Flow analysis. This DNS entry should match the TLS/SSL certificate that the server is utilizing.
Who can use this?
Important: We strongly recommend you use a service account to create this Integration. Please see How to create a service account for instructions and information about why service accounts are important.
BitBucket Server configuration
Follow the BitBucket Server's instructions to create a user. Make sure to set the username and password when your create the user and remember it for later.
Important: Do not check the box to email the user with a link to set their password.
Once you've created the user, click Change permissions, then search for the user you just created and click Add. Click the Admin checkbox for the user you just added. Learn more about BitBucket Server's global permissions.
On your Flow home page, go to the top navigation bar and click Settings. Using the left navigation under Integrations, click Integrations.
Click Add Integration in the top right hand corner of you integrations screen. On the following page select Bitbucket Server from the Integration Provider list and click Next.
In this next step you can choose one of two ways to connect your Bitbucket Server account. Choose the connection that works best for you.
- Username/Password - You can connect to your account using your BitBucket credentials under the Username/Password tab. Input your credentials and base URL and click Test connection.
If the connection was successful you will see a success message.
If you receive an error when trying to connect your Bitbucket Server account verify the following and try again:
- user name and/or password are correct
- base URL is correct
If you are connected behind a firewall, verify the following:
- Flow's IP addresses are allowlisted on port 443
- a public DNS record is set up and pointing to the exposed IP address for Flow's use.
- Access Tokens - You can connect via an access token. On the Access Token tab input your access token and click Test connection. For more information on where to create an access token in BitBucket Server see Bitbucket’s support document Personal access tokens.
If the connection was successful you will see a success message. If you receive an error when trying to connect your Bitbucket Server account using an access token verify the access token and base URL and try again.
Once you have successfully connected to your Bitbucket Server account, click Next.
On the next screen you will be selecting the services you want turned on for this Integration. If you would like to import pull request data in addition to repo data, then leave all services on. You can turn services on and off at any time. Click Next.
Name your integration so you can identify the account you connected with. Click Create.
You can begin to import your repos by going to your repo import page. Click the repo import page link. To learn more about managing your new integration settings, see Manage integrations
If you need help, please email email@example.com for 24/7 assistance.