Clone a Repository

To start committing to a repository, you need to clone it — i.e., set up its working copy on your local machine. You can also edit files in a repository directly from the Space web or desktop UI.

To clone a repository:

If not already done:
- install the latest version of Git
- set up your commit username and email address in Git
Make sure your commit email address matches the email in your Space profile, as Space will use these emails to associate your commits with your Space identity.
Find the project you're going to contribute to.
You need to be a project member and have the Write Git repository permission to be able to commit to the project repositories. Contact your project administrator if you're not sure you have it.
On the project page, locate and open the repository you want to commit to. All project repositories are shown in widgets on the project page.
Go to the Files tab.
The repository README file will be displayed.
Read the repository specific set-up instructions outlined in the README file and find out whether you should use SSH or HTTPS to clone and access the repository.
- To access the repository via SSH, you need to have an SSH public key generated and uploaded to your Space profile.
- To access the repository via HTTPS, you can use your personal token or an application password.
  The scope of permissions for your token or application password should include Git write repository and Git read repository permissions.
- You may be also required to have a GPG key for signing your commits.
Go back to the repository page.
Follow the instructions in README and copy the repository clone URL. It can be SSH or HTTPS depending on the requirements:
Using the URL, clone the repository to your local machine.
Once it's downloaded, you'll be able to work on the source code in your IDE and commit changes to the origin.

Last modified: 02 May 2023