Bitbucket

Instructions for setting up Bitbucket authentication integration for NocoDB

This document provides instructions for setting up the Bitbucket authentication integration for NocoDB.

Environment Variables

To enable OAuth2 authentication with Bitbucket, you need to configure the following environment variables.

Step 1: Create a Bitbucket OAuth Consumer

1. Log in to your Bitbucket account
2. Navigate to Bitbucket Administration Workspace settings → OAuth consumers

• (Bitbucket → left sidebar → click your workspace → Workspace settings → OAuth consumers )

1. Click on “Add consumer”
2. Fill out the form:

• Name : Your application name (e.g., "NocoDB")

• Description : Brief description of your application

• Callback URL : https://your-nocodb-instance.com/

• Permissions : Enable:

• Repositories : Read & Write

• Pull requests : Read & Write

• Issues : Read & Write

• Account : Read

1. Click Save

Step 2: Get Client ID and Client Secret

After creating your OAuth consumer:

1. Bitbucket will display:

• Key → Client ID
• Secret → Client Secret

1. Copy both values (the Secret is shown only once )
2. Store them safely for configuration

Step 3: Set Environment Variables

Configure your NocoDB instance with:

INTEGRATION_AUTH_BITBUCKET_CLIENT_ID=your_bitbucket_client_id
INTEGRATION_AUTH_BITBUCKET_CLIENT_SECRET=your_bitbucket_client_secret
INTEGRATION_AUTH_BITBUCKET_REDIRECT_URI=your_redirect_uri

Where:

• your_bitbucket_client_id → The Key (Client ID) from Bitbucket
• your_bitbucket_client_secret → The Secret (Client Secret)
• your_redirect_uri → The callback URL used in the OAuth consumer (e.g., https://your-nocodb-instance.com/)

OAuth Scopes Requested

The integration will request these Bitbucket scopes:

• repository
• repository:write
• pullrequest
• pullrequest:write
• issue
• issue:write
• account

These permissions allow NocoDB to read/write repositories, issues, and pull requests as needed.

Availability

• App Sync is available on NocoDB Cloud (Plus plan and above) and licensed self-hosted deployments (Business plan and above). This page covers OAuth app setup for self-hosted deployments; on NocoDB Cloud these OAuth apps are preconfigured.

Related pages

• GitHub : Instructions for setting up GitHub authentication integration for NocoDB
• GitLab : Instructions for setting up GitLab authentication integration for NocoDB
• Google Calendar : Instructions for setting up Google Calendar authentication integration for NocoDB
• Linear : Instructions for setting up Linear authentication integration for NocoDB
• Outlook Calendar : Instructions for setting up Outlook Calendar authentication integration for NocoDB