How do I add an SSH key as opposed to a deployment keys

This question is in reference to Atlassian Documentation: Set up SSH for Git

I am trying to set up ssh keys for bitbucket, using this guide:

In step 4.5, I am asked to input the SSH key. However, it describes how to input Deployment keys, which are read only. The page unhelpfully notes that:


Deployment keys

Use deployment keys to gain read-only access to this repository. Learn more about using SSH keys."

However, if you follow the link to "using SSH keys" you get back to the same guide that lead you to the deployment keys in the first place. So my question is simply: exactly where in Bitbucket do I enter the SSH key? The guide only says "Back in your browser", but provides no URL.

5 answers

Basically, you should add your keys to your profile, not to a project.

Atlassian's UX has always been "pretty but cryptic".

This is a prime example where UX, documentation and even the forum fail.

In every case they assume you know what they know. Actually I dont think they are aware of what the confusion is.

This mostly happens to first time users who do not set up an rsa key in their profile right away.  Then, when set up their first project the tutorials send them looking for something with the word "Keys" in the interface. They find it first in the screen they are working with: the project's screen.

So,  put your Key here:

Screen Shot 2017-08-22 at 2.07.55 PM.png


NOT HERE... in your project:

Screen Shot 2017-08-22 at 2.11.59 PM.png

You rock. Super helpful. Thank you!

Extremely helpful.  Thanks a lot!

Hello everyone! Is there other way for this? Still getting the error after I added the ssh key of the server pulling the repo. thank you so much

You first need to remove the access key from any repository where it is installed. Once that is done, add the key to your user account (as displayed in the first image above).

I've fallen for this trap too.

Allow me to point out that even after setting BitBucket account SSH key, I still had project SSH key present and this was taking precedence.

Even after removing the project key I still got the 'read-only access' error.

I had to go into GitKraken authentications and disconnect/reconnect to BitBucket to finally Push with success.

To clarify, when I try to do a git push, I get this error, which is due to the fact that I am using a read-only deployment key:

conq: repository access denied. access via a deployment key is read-only.


As I said in my original question, I do get to that point, and all it says is that I should input the SSH key  "Back in your browser". The problem is that no URL is provided, and the only obvious place "back in the browser" is the place where you input read-only deployment key, which brings me back to where the problems started. All I need is the URL for the place to put the non-deployment key.

On that document that you linked above (, if you expand the Collapsed "Set up SSH for Windows" or "Set up SSH for Mac OS/Linux" you should be able to see the step where you upload your public key to Bitbucket. The section should be called "Install the public key on your Bitbucket account".

0 vote

Awesome.... +1

Suggest an answer

Log in or Sign up to answer
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Posted Jun 12, 2018 in Bitbucket

Do you use any Atlassian products for your personal projects?

After spinning my wheels trying to get organized enough to write a book for National Novel Writing Month (NaNoWriMo) I took my affinity for Atlassian products from my work life and decided to tr...

29,457 views 26 12
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you