Skip to main content

Connecting Bitbucket Server instances

Abstract

Connect your Bitrise workspace to Bitbucket Server to access your privately hosted repositories for CI builds.

Connect your Bitrise workspace to Bitbucket Server to access your privately hosted repositories for CI builds. You need to:

  • Create a new Application Link on your server.

  • Authorize Bitrise and assign the required permissions.

  • Copy the necessary credentials to your workspace settings.

Publicly resolvable IP address

Your self-hosted instance must have a publicly resolvable IP address, otherwise Bitrise won’t be able to connect to it.

  1. Log in to your Bitbucket Server instance with admin privileges.

  2. Click the settings icon on the top menu bar to access Administration.

  3. On the left menu bar, find the Integrations section, and select Application Links.

  4. Click Create link.

    2025-11-13-bitbucket-app-links.png

  5. Select External Application, and Incoming as the direction.

  6. In the Name field, enter a name that clearly identifies the application. For the sake of simplicity, we recommend Bitrise.

  7. In the Redirect URL field, enter https://app.bitrise.io/users/auth/bitbucket_server/callback.

  8. Under Application permissions, find Repositories and select Admin.

  9. Click Save. You will be taken to the Credentials page.

    20251113-bitbucket-credentials.png

  10. Copy the Client ID and the Client secret.

  11. Open the Workspace settings page on Bitrise and select Integrations.

  12. Select Bitbucket Server and then click Add credentials.

    2025-11-13-bitbucket-server-integration.png

  13. Add your credentials:

    • Client ID

    • Client secret

    • URL: Your server's base URL

To test the connection, try to add a new project and select Bitbucket Server as your Git provider.

In this section: