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.
To create a repository
- Click + in the global sidebar and select Repository under Create.
- Select the Workspace where you want to create the repository.
- Select a project from the Project dropdown menu. If a project does not exist, click on Create new project at the bottom of the Project dropdown menu to create a new project in which to work and collaborate with others on your repository.
- Enter a Repository name that will describe your repository and appear in its URL.
- 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 a one of the included README options.
- Select the Version control system. If you don't know the difference, keep Git as the default system.
- 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.