How to add files folders to empty repo

Hi, I have an empty repo where I want to add a local project (not repo).

How can I upload my files/folders so it becomes a bitbucket private repo?

7 answers

1 accepted

6 votes
Accepted answer

Ok. So you want to start by making a new private repo on bitbucket. On your dashboard, you can "Create Repository". It can be git or hg (short for mercurial), your choice.

To interact with your new repository, you'll need to clone this repository to your local machine using a git/hg client. Many here would recommend SourceTree (another Atlassian product, integrates well with Bitbucket, you can use a "Clone To SourceTree" button in Bitbucket to make things easier) but any git client will work. The information you need for SourceTree or command line is in the "Clone" dropdown.

Once you have a local repository, copy/move your project into it, and use your chosen tool to add/commit the files and push them to bitbucket.

As far as I can tell, there is no way to upload files directly to an empty repository on Bitbucket except by pushing from a git/hg client.

Thanks for the info

Thank you. This is the first concise answer. I have been tearing my hair out just trying to do this simple task. It would be easier if you could just add an existing local folder with files in it, but you have to add an empty local folder and then copy files into it. Strange. I kept getting a message saying that the folder already has files in it, please choose an empty folder. Ahhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh!

What if I already have a private repo with a file and I just want to add a folder with some css, html, js files to the repository? What do I do? 

This is so dumb. What's so hard about uploading some files? Grrr....

lol glad you asked, John. perhaps you can riddle me this: i have on my local, folder A and B [each is set up via git init]. on Bitbucket, i have a public key. on Bitbucket i have root folder, and folders A and B. i can add, commit, and push from my local folder A, to my root folder in bitbucket. but i cannot push from folder B to anywhere. >>i want to be able to push from folder A local to Bitbucket folder A, and local B to Bitbucket B. my errors are a few that i get as i try different things:

git push - says i need to do "git push --set-upstream origin master", but that says repository does not exist. so i do a "git remote add origin:, that says "remote origin already exists".

i double check my ssh: ssh-add, that shows my identity already added. also, eval "$(ssh-agent)" returns, "Agent pid 20268".

git push origin ==> 'master' does not appear to be git repo. fatal - could not read from remote repo. make sure you have correct rights.

going in circles! yet, from my other folder, A, i can push no problem.


As a new user, have you checked Bitbucket 101?

If you'd rather, you can start here:

The Bitbucket 101 link still exists in their documentation, but as you mentioned, it returns a 404.

The Get Started link in the above URl returns

503 Service Unavailable

No server is available to handle this request.


Is there any other links for new users to learn?

So, Bitbucket 101 has been multiplied by four...

Git or Mercurial?

It sounds like you have created an empty local repository, and you want to put an existing project into it and upload that project to bitbucket.

You can copy/move your existing project into your local repo, then use your chosen system's tools to add all the files to the local repo.

For Bitbucket, you want to create a new private repository. In the "Get Started" area, there is a link "I have an existing project to push up" that will give you command line instructions on how to push your existing repository to bitbucket.

I have no local repo, I want to make my proyect become a repo that I can upload to bitbucket while keeping it private.

Notice this is my very first time using bitbucket

none for this proyect, it's just a phonegap project


Please help with the configuration of Bitbucket Server to be able to view the push sent from SourceTree, since at the moment I have made all the required configurations but when adding a file in the cloned local repository, it is committed and sent by Push to the Server , but it is not displayed.

Please if anyone can give me support regarding the subject.

First of all, Thanks.



I installed a free app from the Mac App Store called SnailGit Lite. It is a lightweight client that extends Finder to allow you to use Finder as your Git client rather than SourceTree etc. 

All you need to do is navigate to the folder you want to turn into a repo and click the button in Finder and select "Create a repo here". Boom. That folder is now a repo, ready to be uploaded/committed to wherever.

Admittedly, I ran into the annoying and numerous "Make sure you have permissions" bugs where I first have to setup SSH keys and all that nonsense before I am allowed to upload / download anything so I went back to SourceTree after this step but still... You say your repo is empty, right? So just turn the current folder into a Repo. Start up SourceTree and commit that brand spanking new repo. 

Two clicks in Finder (literally) vs creating a repo online, cloning it, moving files around and then uploading back again... your choice :)

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

211 views 3 7
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