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

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.

6 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

Jim Redmond Atlassian Team Jun 04, 2018

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.

This is DAMN helpful! Btw, any one knows what the deployment key is for?

This did for me! ... Thank you!!

Marco I'm New Here Dec 10, 2018

Great! Thank you.

You made my day!

@Alejandro Colina dude your post was a life saviour, even a year and a half later.  Feel exactly into the trap that you speak of, and after 3 hours of chasing rabbit holes due to misleading articles, did I come across the gem of your post.  Thank you.

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

Awesome.... +1

Awesome! BUT:


And if I want to give permission only in SPECIFIC Repository for one given SSH KEY? 

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Nov 06, 2018 in Bitbucket

Upgrade Best Practices

Hello! My name is Mark Askew and I am a Premier Support Engineer for products Bitbucket Server/Data Center, Fisheye & Crucible. Today, I want to bring the discussion that Jennifer, Matt, and ...

655 views 5 9
Read article

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