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.

4 answers

4 votes

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

keira25 I'm New Here Jan 05, 2018

Thank you!


Yes! Thank you!

You rock. Super helpful. 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".

Suggest an answer

Log in or Join to answer
Community showcase
Piotr Plewa
Published Dec 27, 2017 in Bitbucket

Recipe: Deploying AWS Lambda functions with Bitbucket Pipelines

Bitbucket Pipelines helps me manage and automate a number of serverless deployments to AWS Lambda and this is how I do it. I'm building Node.js Lambda functions using node-lambda&nbsp...

656 views 0 4
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
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot