> For the complete documentation index, see [llms.txt](https://docs.nullify.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nullify.ai/enterprise-tier/bitbucket-install.md).

# Bitbucket Install

Nullify is available as a Bitbucket App that can be installed across select repositories or all current and future repositories, allowing for workspace-wide coverage in one click.

Please reach out to our team to assist with your workspace setup.

Nullify is distributed as a Bitbucket Connect App. You install it from a descriptor URL provided by Nullify; Bitbucket then calls back to Nullify automatically to complete the installation and register the required webhooks (`repo:push`, `pullrequest:created`, `pullrequest:updated`, `pullrequest:comment_created`). There is no OAuth consumer to create and no Key/Secret to share.

## Install Nullify

### Setting up your Bitbucket App

1. Navigate to your Bitbucket workspace settings and go to **Apps and features**.

<figure><img src="/files/D5QRFpXVHRsHx5raTOxi" alt="Bitbucket Apps and features page"><figcaption><p>Apps and features page</p></figcaption></figure>

2. Click on **Installed apps** in the left sidebar.
3. Enable **Development mode** by ticking the checkbox.
4. Click on **Install app from URL**.

<figure><img src="/files/bhAI9okLb1Lz5UGzC25Q" alt="Install app from URL button"><figcaption><p>Install app from URL</p></figcaption></figure>

5. Paste in the Nullify descriptor URL provided by your Nullify representative. It is of the form `https://api.<your-organization>.nullify.ai/core/bitbucket/descriptor`.

<figure><img src="/files/SF6Th8IPmJf74fSbB6gf" alt="Install app from URL modal"><figcaption><p>Install app from URL modal</p></figcaption></figure>

6. Review the requested scopes (`account`, `repository`, `pullrequest`) and click **Install** to approve.
7. Bitbucket calls Nullify's install endpoint automatically, which registers the app for your workspace and sets up the webhooks. No manual webhook creation is required.

### Final Steps

8. Wait for your stack to be provisioned by the Nullify team.
9. Once provisioned, you'll receive confirmation and can begin using Nullify to assess your Bitbucket repositories.

## Support

If you encounter any issues during the installation process, please contact our support team for assistance.