Create a Mercurial repository
- Create a Mercurial repository
- Copy your Mercurial repository and add source files
- Pull changes from your Mercurial repository on Bitbucket
- Use a Mercurial bookmark to update a file
As our new Bitbucket space station administrator, you need to be organized. When you make files for your space station, you’ll want to keep them in one place and shareable with teammates, no matter where they are in the universe. With Bitbucket, that means adding everything to a repository. Let’s create one!
- You have access to all files in your local repository, whether you are working on one file or multiple files.
- You can view public repositories without a Bitbucket account if you have the URL for that repository.
- Each repository belongs to a user account or a team. In the case of a user account, that user owns the repository. In the case of a team, that team owns it.
- The repository owner is the only person who can delete the repository. If the repository belongs to a team, an admin can delete the repository.
- A code project can consist of multiple repositories across multiple accounts but can also be a single repository from a single account.
- Each repository has a 2 GB size limit, but we recommend keeping your repository no larger than 1 GB.
Step 1. Create the repository
Initially, the repository you create in Bitbucket is going to be empty without any code in it. That's okay because you will start adding some files to it soon. This Bitbucket repository will be the central repository for your files, which means that others can access that repository if you give them permission. You will also copy a version of that repository to your local system—that way you can update it from one repo, then transfer those changes to the other.
Do the following to create your repository:
- From Bitbucket, click the + icon in the global sidebar and select Repository.
Bitbucket displays the Create a new repository page. Take some time to review the dialog's contents. With the exception of the Repository type, everything you enter on this page you can later change.
BitbucketStationTeammatesfor the Name field.
Bitbucket uses this Name in the URL of the repository. For example, if the user
the_besthas a repository called
awesome_repo, the URL for that repository would be
- For Access level, leave the This is a private repository box checked.
A private repository is only visible to you and those you give access to. If this box is unchecked, everyone can see your repository.
- Pick Mercurial for the Repository type. Keep in mind that you can't change the repository type after you click Create repository.
- Click Create repository.
Bitbucket creates your repository and displays its Overview page.
Step 2. Explore your new repository
Take some time to explore the repository you have just created. You should be on the repository's Overview page:
Click + from the global sidebar for common actions for a repository. Click items in the navigation sidebar to see what's behind each one, including Settings to update repository details and other settings. To view the shortcuts available to navigate these items, press the ? key on your keyboard.
When you click the Commits option in the sidebar, you find that you have no commits because you have not created any content for your repository. Your repository is private and you have not invited anyone to the repository, so the only person who can create or edit the repository's content right now is you, the repository owner.