Docs

Bitbucket Integration

Learn how to integrate Bitbucket with Cokpit

Bitbucket Credentials

Step 1: Create App Password on Bitbucket

Example: App Password

  1. Go to Bitbucket Settings → Personal Settings → App passwords.

  2. Click Create app password.

  3. In the create dialog:

    • Enter a descriptive Label for your app password
    • Select the required permissions (at minimum: Repository Read, Repository Write)
    • Click Create
  4. Copy the app password immediately (you won't be able to see it again)

💡 Tip: Store your app password securely. You won't be able to see it again!

Step 2: Add Bitbucket Credentials to Cokpit

  1. Open Cokpit and go to Integrations → Version Control → Bitbucket.
  1. Click Add secret.
  2. Fill in the required fields:
    • Enter a unique Secret Name
    • Enter your Bitbucket Username
    • Paste your App Password/ API Token
    • Enter your Bitbucket Email
  3. Click Submit.

Security Best Practices

  • Create app passwords with minimal required permissions.
  • Use different passwords for different applications.
  • Regularly rotate your app passwords.
  • Enable two-factor authentication on Bitbucket.
  • Monitor app password usage in Bitbucket security logs.