How to authorize Bitbucket Pipelines to access a private Docker Hub repository?

I'm trying to use Bitbucket Pipelines with a private repo on Docker Hub, but I've been spidering around the docs and can't for the life of me find out how to authorize BBP to access it. I tried anyway to see what would happen, and the build unsurprisingly says it can't find that image.


How can I authorize BBP to access the private repo? The BB Pipelines docs assure me that "we support public and private Docker images from Docker Hub or your own registry," but don't mention *how*.

1 answer

1 accepted

I think I'm missing something. I have read and read that page and it has not helped me yet.

I have tried putting the image at the top of my file and in the step. In each case, if I try to add username, password and email, the image is not pulled. If I only list the image, the pull is attempted but fails.

I must be missing some small detail. Any help is greatly appreciated!

@Eddie Bush the answer to the auth problem is pretty early in the article:


  name: <aws_account_id>.dkr.ecr.<region>
    access-key: $AWS_ACCESS_KEY
    secret-key: $AWS_SECRET_KEY


the image field supports more than just the image name

Thanks, @Jeremy Stafford. I'm actually using DockerHub for mine, and I wouldn't exactly say that the instructions worked for me.


Thanks for the follow-up though!

@Eddie Bush @@ There are examples for both private and public dockerhubs. What exactly isn't wo

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

1,945 views 7 10
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