Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

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?

10 answers

1 accepted

16 votes
Answer accepted
Seth Rising Star Mar 31, 2014

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!

Like # people like this

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? 

Like zepre likes this

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

Like # people like this

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.


Like # people like this

I  have a folder on my computer with my server. I can not put it on a repo in bitbucket, unless I add 14000 files one at a time? what do I do?

To add files & folder into empty repo:

1. First make clone of that empty existing repo onto your local machine by using command "git clone your repo path".

2. After making clone ,paste your files & folders into that clone.

3. After open git bash from clone directory & just add your code by using "git add -A" command,then commit using command "git commit -m "your message"" & then final push your code using command "git push".


Thats it.

Push the file to BB, the folder will go too

1 vote
Seth Rising Star Mar 31, 2014

As a new user, have you checked Bitbucket 101?

Like # people like this
Seth Rising Star Mar 21, 2017

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

Like # people like this

I struggled with this as well for a good half an hour!

Go to your top level project (as given in the URL then click Settings, SSH Keys, and add key there.

Make sure the SSH key hasn't been added elsewhere, like per person settings.

If you have read/write permissions on the repository (check your groups), then that's all you have to do. ssh -T should tell you:

logged in as top_level_project

You can use git or hg to connect to Bitbucket. Shell access is disabled

Set up your username and key file in your ~/.ssh/config file. Good luck!

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 :)


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.



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

0 votes
Seth Rising Star Mar 31, 2014

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

0 votes
Seth Rising Star Mar 31, 2014

Git or Mercurial?

Suggest an answer

Log in or Sign up to answer

Atlassian Community Events