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.

Usage limits

• Bitbucket-specific repository issues (not issues connected via your Jira integration): 10,000 issues per repository

• Pull request comments: 1,000 comments per pull request

• Pull request tasks: 100 tasks per pull request

• Snippets: 10,000 snippets per workspace

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