> ## Documentation Index
> Fetch the complete documentation index at: https://launchdarkly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Bitbucket Pipelines

<View title="Developer" />

<View title="Federal docs">
  <Danger>
    **This integration is not available in federal environments**

    To learn more, read <a href="/docs/home/infrastructure/federal">LaunchDarkly in federal environments</a>.
  </Danger>
</View>

<View title="EU docs">
  <Danger>
    **This integration is not available in LaunchDarkly's European Union (EU) instance**

    To learn more, read <a href="/docs/home/infrastructure/eu">LaunchDarkly in the European Union (EU)</a>.
  </Danger>
</View>

<Note>
  **The Bitbucket Pipelines integration is available to customers on select plans**

  The Bitbucket Pipelines integration is only available to customers on select plans. To learn more, [read about our pricing](https://launchdarkly.com/pricing/). To upgrade your plan, [contact Sales](https://launchdarkly.com/contact-sales/).
</Note>

This topic explains how to create and enable feature flags using Bitbucket Pipelines.

The LaunchDarkly integration lets you insert feature flag actions directly into your Pipeline's continuous delivery flow. [Bitbucket Pipelines](https://bitbucket.org/product/features/pipelines) is a continuous delivery platform that lets your team build, test, and deploy from Bitbucket. It exists within Bitbucket, giving you end-to-end visibility from coding to deployment.

We provide two scripts you can add to your pipelines:

* **Create feature flags in your Pipelines build**: This lets you create feature flags within a specified project. The feature flag will be created in all environments for that project.
* **Enable a feature flag in your Pipelines build**: This lets you turn on a specific feature flag for a specific environment within a project.

## Prerequisites

To use the LaunchDarkly Bitbucket Pipelines integration, you must meet the following prerequisites:

* [A Bitbucket account](https://bitbucket.org/account/signup/)
* [Bitbucket Pipelines](https://bitbucket.org/product/features/pipelines) installed on your Bitbucket account

## Create feature flags in your Pipelines build

You can configure a Bitbucket Pipeline step to create a set of feature flags in LaunchDarkly as part of your build process.

To set up your Bitbucket Pipeline with LaunchDarkly:

1. Copy the `create-launchdarkly-flags.sh` shell script from our [Bitbucket repository](https://bitbucket.org/launchdarkly/launchdarkly-pipelines/src).
2. Add `create-launchdarkly-flags.sh` to your Pipelines build configuration.
3. Add two environment variables to your Pipelines settings:
   * `LAUNCHDARKLY_ACCESS_TOKEN`: Copy your API access token from the [Authorizations tab](https://app.launchdarkly.com/settings/authorization) within Account settings.
   * `LAUNCHDARKLY_PROJECT_KEY`: Copy your project key from your [LaunchDarkly Projects tab](https://app.launchdarkly.com/settings/projects) within Account settings.

<Frame caption="The Access tokens section of the Authorization tab.">
  <img src="https://mintcdn.com/launchdarkly/A4UXoRTW8ATNw4yq/images/auto/settings-access-tokens.auto.png?fit=max&auto=format&n=A4UXoRTW8ATNw4yq&q=85&s=f8901bdc6cf07791cc9aa32e8490c47a" alt="The Access tokens section of the Authorization tab." width="2644" height="544" data-path="images/auto/settings-access-tokens.auto.png" />
</Frame>

<Warning>
  **Do not use the LaunchDarkly environment key**

  Be careful to use the LaunchDarkly **project key** in the Bitbucket Pipelines settings, not the environment key. To learn how to find your project key, read [Project keys](/docs/home/account/project#project-keys).
</Warning>

4. Add an `ld-flags.conf` file to your repository and declare flags in it.

When your Pipelines build runs, any feature flags you declare in this file is also created in LaunchDarkly.

## Enable a feature flag in your Pipelines build

You can configure a Pipeline step that enables an existing feature flag in an environment as part of your build.

To enable feature flags with Bitbucket Pipelines:

1. Copy the `enable-launchdarkly-flags.sh` shell script from our [Bitbucket repository](https://bitbucket.org/launchdarkly/launchdarkly-pipelines/src).
2. Add `enable-launchdarkly-flags.sh` to your Pipelines build configuration.
3. Add these environment variables to your Pipelines settings:
   * `LAUNCHDARKLY_ACCESS_TOKEN`: Copy your API access token from the [Authorization tab](https://app.launchdarkly.com/settings/authorization).
   * `LAUNCHDARKLY_PROJECT_KEY`: To learn how to find your project key, read [Project keys](/docs/home/account/project#project-keys).
   * `LAUNCHDARKLY_ENVIRONMENT_KEY`: Copy your environment key from your [LaunchDarkly Projects tab](https://app.launchdarkly.com/settings/projects).
   * `LAUNCHDARKLY_FLAG_KEY`: Enter the key for the feature flag you wish to enable.