> 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nullify.ai/enterprise-tier/bitbucket-install.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
