Create a repository

Whether you have no files or many files, you'll first want to create a repository on Bitbucket Cloud. From there, you can clone your repository to your local system and start working on it.

If you name a repository with upper case letters, you'll see the name with upper case letters in Bitbucket, but Bitbucket converts the name to all lower case in the repository UR. As a result, you can't create two repositories with names that result in the same URL.

Create a repository

  1. Select + in the global sidebar and select Repository under Create a new.

  2. Choose a repository Workspace

  3. Select a project from the Project dropdown menu or Create new project at the bottom of the menu to create a new project.

  4. Enter a Repository name that will describe your repository and appear in its URL.

  5. Keep access to your repository set to Private unless you want to make your repository public so that anyone can see it.

  6. If you already have files that you want to add to your repository, select No from Include a README? Otherwise, go with the default option or select a one of the included README options.

  7. Select the Version control system. If you don't know the difference, keep Git as the default system.

  8. Click Create.

After you create a repository

What comes next depends on what you want to do with your repository:

  • Starting from scratch with no files? — Clone the repository to your local system to connect Bitbucket repository to a local directory. Learn how

  • Working on existing files that aren't under version control? — Add unversioned files to a repository before pushing them to Bitbucket. Learn how

  • Already have local files in a Git or Mercurial repository? — Push versioned code to an empty repository, maintaining commit history. Learn how

Take a minute to explore what comes with your new repository.

Additional Help

Ask the Community