# GitHub Setup

To be added to the current GitHub repositories, please Slack your project leader your GitHub username

## Setting up SSH

To authenticate your local computer, you need a way to confirm your identity with GitHub. To do this, we recommend using SSH. You can read more here: [https://www.cloudflare.com/learning/access-management/what-is-ssh/](https://www.cloudflare.com/learning/access-management/what-is-ssh/)

To set up SSH, follow these steps

1. Create a SSH key if you don't already have one. Open a terminal and run the following. Please DO NOT USE COMMAND PROMPT.&#x20;
   1. `cd ~/.ssh`
   2. `ls`
   3. Check if you have a file that ends in `.pub`. Examples include `id_rsa.pub` or `id_ed25519.pub`.
   4. If you do, run `cat <pubkey file>` and copy the key
   5. If you don't have a file like that, please run `ssh-keygen -t ed25519` to create a SSH key and then copy the key.
2. Navigate to GitHub's interface and click on your profile picture, then click `SSH and GPG Keys`. Add your SSH key you copied above into GitHub

## Cloning a repository

Navigate to the repository and click the green "clone" button. Select "SSH" as the tab option and copy the link:

<figure><img src="https://3246829168-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOBPUn06p2VQiK8dW3pV9%2Fuploads%2F2I66cqVedeDM8CzP201m%2Fimage.png?alt=media&#x26;token=50249cfb-7fd9-4d98-9d35-410d8a80b43e" alt=""><figcaption></figcaption></figure>

Then navigate to a suitable location to clone the repository, such as `~/Documents` and run:

`git clone <ssh link>`

Congrats, you've clone the repository! Now just navigate into the repository and run VS Code!
