GitHub Setup

Add SSH Key to GitHub

  1. Create a GitHub Account if you do not already have one

    Go to www.github.com to create a GitHub account if you do not already have one. Your username has to be globally unique, and the email address you use to register GitHub can be any email address you own.

  2. Upload your Public key to GitHub

    1. Log into to your GitHub account if you are not already logged in
    2. Click on your profile icon on the top-right of the screen and select Settings from the dropdown
    3. Click on SSH and GPG keys from the left hand menu
    4. Click on the New SSH key button on the top-right
    5. Give your key a name. This is just a name and is meaningful to you.
    6. Paste the contents of the public key in the Key box. Leave the “Key Type” dropdown as “Authentication Key”.
    7. Click the Add SSH Key button

  3. Test that your ssh key works with GitHub

    1. Open a terminal if not already open on your laptop

    2. At the command prompt, type ssh -T git@github.com and press enter to test. If it works, you will see something like this, with your GitHub username:

      The authenticity of host 'github.com (192.30.253.112)' can't be established.
RSA key fingerprint is SHA256:nThbg6kXUpJWGl7E1IGOCspRomTxdCARLviKw6E5SY8.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'github.com,192.30.253.112' (RSA) to the list of known hosts.
Hi wahalulu! You've successfully authenticated, but GitHub does not provide shell access.
Note

You are now ready to use ssh authentication with GitHub.

Create a Personal Access Token on GitHub

  1. Log into to your GitHub account if you are not already logged in

  2. Click on your profile icon on the top-right of the screen and select Settings from the dropdown

  3. Click Developer settings

  4. Click the Personal access tokens tab

  5. Click the Generate new token button

  6. Enter a token description (you can call it big-data-class)

  7. Select the repo permission, and then click the Generate token button

  8. Copy the token and save it in a text file. You will need this token later on in the semester and if you lose it you will need to re-generate a token