> 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="https://3946391995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FId2OtLCL6O6V3XSRYxtr%2Fuploads%2Fgit-blob-f192360920f35adda11d085e6beebfafa73b3864%2Finstalled_apps.png?alt=media" 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="https://3946391995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FId2OtLCL6O6V3XSRYxtr%2Fuploads%2Fgit-blob-9815e5710df684919d6a25a5bb7c4530418beada%2Finstall_app_from_url.png?alt=media" 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="https://3946391995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FId2OtLCL6O6V3XSRYxtr%2Fuploads%2Fgit-blob-45ef5ff5b525055c0b0d5117f33f71eec24b35ca%2Finstall_app_from_url_modal.png?alt=media" 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.