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
Select the Create button and select Repository from the dropdown menu.
Select a project from the Project dropdown menu or Create new project at the bottom of the menu to create a new project.
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 a hyphen in the repository slug.
Keep access to your repository set to Private unless you want to make your repository public so that anyone can see it.
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.
Select Create.
Usage limits
Bitbucket-specific repository issues (not work items connected via your Jira integration): 10,000 issues per repository
Pull request comments: 200 comments per pull request
Pull request tasks: 100 combined tasks and comment tasks per pull request
Default reviewers: 50 default reviewers per repository
Default tasks: 50 default tasks per repository
Commit comments: 100 comments per commit
Branch restrictions: 70 branch restrictions per repository; 20 users per branch restriction; 10 groups per branch restriction
Snippets: 10,000 snippets per workspace
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.
Was this helpful?