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 URL. As a result, you can't create two repositories with names that result in the same URL.

Create a repository

  1. Select the Create button and select Repository from the dropdown menu.

  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. Make sure your repository name is under the 62 character limit, which is put in place to limit the size of the repository slug which appears in the URL. Note: Any special character used in naming your repository will be converted to an en dash in the repository slug.

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