# EkLine Bitbucket integration guide

## Prerequisites

1. You have an EkLine integration token. You can obtain this from **Settings > Organization > Access** in the [EkLine dashboard](https://ekline.io/dashboard).
2. You have a Bitbucket account and the necessary permissions to configure pipelines.

## Create `bitbucket-pipelines.yml` file

Create a new file named **`bitbucket-pipelines.yml`** in your project's root directory and add the following content:

```yaml
runEkLineStep: &runEkLineStep
  name: EkLine Documentation Review
  image:
    name: ghcr.io/ekline-io/ekline-ci-cd:v6.8
  script:
    - export INPUT_EK_TOKEN=$EK_TOKEN
    - export INPUT_CONTENT_DIR='<path_to_content_directory>'
    # Uncomment and configure the following lines to use additional options:
    # - export INPUT_EXCLUDE_DIRECTORIES='<dir_to_exclude>'
    # - export INPUT_EXCLUDE_FILES='<file_to_exclude.md>'
    - /entrypoint.sh

pipelines:
  branches:
    main:
      - step: *runEkLineStep

  pull-requests:
    '**':
      - step: *runEkLineStep
```

Replace **`<path_to_content_directory>`** with the actual path to your content directory.

## Configure Bitbucket environment variables

1. In Bitbucket, navigate to your repository settings.
2. Go to **Repository settings > Pipelines > Repository variables**.
3. Add the following variables:
    **`EK_TOKEN`**: Your EkLine integration token.

## Configure input options

### Ignoring specific rules (optional)

To ignore specific rules during the review process, you can use the `INPUT_IGNORE_RULE` flag. This flag accepts a comma-separated list of rule identifiers that you want to skip.

For example, to ignore rules `EK00001` and `EK00004`, you can set the `INPUT_IGNORE_RULE` flag in your configuration like this:

```yaml
  INPUT_IGNORE_RULE: "EK00001,EK00004"
```

## Next steps

- [Ignoring rules](/reviewer/configuration/ignoring-rules/) — handle false positives and suppress specific checks
- [Framework support](/reviewer/configuration/framework-support/) — configure EkLine for MDX, Astro, Docusaurus, and other frameworks
- [GitHub Actions integration](/reviewer/integrations/github-integration/) — set up EkLine in GitHub if you also use GitHub
- [Docs Agent](/agent/) — generate and update documentation from your codebase with AI