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

## 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** and paste in the link provided by Nullify.

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

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

### Creating an OAuth Consumer

5. Create an OAuth Consumer in Bitbucket by navigating to one of these URLs:
   * `https://bitbucket.org/account/settings/app-passwords`
   * `https://bitbucket.org/account/settings/oauth-consumers/`
6. Click **Add consumer**. You should be taken to a URL like: `https://bitbucket.org/your-org/workspace/settings/oauth-consumers/new`
7. Fill in the following details:

   **Name:** `Nullify`

   **Callback URL:** We will provide you this URL.
8. Grant the following **permissions**:

| **Permission**       | **Access**   | **Explanation**                                     |
| -------------------- | ------------ | --------------------------------------------------- |
| Account              | Read         | Required to access account information              |
| Workspace membership | Read         | Required to read workspace member information       |
| Projects             | Read & Write | Required to access and manage projects              |
| Repositories         | Read & Write | Required to review repositories and create comments |
| Pull Requests        | Read & Write | Required to create and modify pull request comments |
| Issues               | Read & Write | Required to create and modify issues                |
| Webhooks             | Read & Write | Required to set up webhooks for processing events   |

<figure><img src="/files/FiGCzBHuJD9b6BJtyxWq" alt="OAuth consumer permissions"><figcaption><p>OAuth consumer permissions</p></figcaption></figure>

9. Click **Save** and copy the **Key** and **Secret**.
10. Send the Key and Secret to Nullify. This can be done via a password manager or secure communication channel.

### Final Steps

11. Wait for your stack to be provisioned by the Nullify team.
12. 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: 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.