# BitBucket

{% hint style="warning" %}
You must use the `git@...` or `ssh:...` version of your git URL, not the `https://...` version. Paradime uses the SSH protocol to clone repositories, so Paradime will be unable to clone repos supplied with the HTTP protocol.
{% endhint %}

### BitBucket Cloud

{% hint style="success" %}
We advise creating a service account user in your Bitbucket account like **`paradime.bitbucket.maintainer@yourcompany.com`** with write access to the repository and let this user own the SSH key.
{% endhint %}

To add a deploy key to a BitBucket Cloud user account, navigate to the "SSH keys" tab in the Personal Settings page of your BitBucket Cloud account. 

Next, click the "Add key" button and paste in the deploy key generated by Paradime for your repository. After saving this SSH key, Paradime will be able to read and write files in your BitBucket repository.

<figure><img src="https://2337193041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHET0AD04uHMgdeLAjptq%2Fuploads%2FBxZrO5lCvAB1wY0Eb5SH%2Fimage.png?alt=media&#x26;token=c340e330-8e3a-417c-b21e-45df32e6bbe9" alt=""><figcaption><p><em>Configuring a Bitbucket Cloud Deploy Key</em></p></figcaption></figure>

### BitBucket Server

{% hint style="info" %}
Bitbucket Server **support** `SSH access key for system use` to have Read/Write access.
{% endhint %}

To add a Deploy key to a Bitbucket Server repository, navigate to the Settings tab of the repository. Click on Access keys and then Add key.&#x20;

Make sure to choose the Read/Write permission, paste the Key generated by Paradime and click Add Key. Paradime will be able to read and write files in your BitBucket repository.

{% embed url="<https://confluence.atlassian.com/bitbucketserver/ssh-access-keys-for-system-use-776639781.html>" %}


---

# 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.paradime.io/app-help/documentation/settings/git-repositories/importing-a-repository/bitbucket.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.