DEV Community

Cover image for Adding SSH Keys to Your GitHub Account
Richard Francis
Richard Francis

Posted on • Updated on

Adding SSH Keys to Your GitHub Account

Github SSH key Setup

Requirements

  1. Surely a github account 🤓
  2. A Mac/Linux/Windows or Android devices (Yes, I once had my Android device setup for pushing little changes when I couldn't get my PC) 😁
  3. Internet Connection 😌
  4. Little knowledge of the Terminal (Command Line) 😋

NOTE: To follow up with an Android device download "Termux" and run the Linux commands

Alright Let's Go
Enter fullscreen mode Exit fullscreen mode

Step One : Checking For Existing SSH Keys

Linux, Mac & Windows(Git Bash)

First, we're gonna check if there's an existing SSH key on your device.
NOTE: If you're sure you don't have existing SSH keys you can skip this step to the next one.

Open Terminal

Enter the following command to see if existing SSH keys are present

$ ls -al ~/.ssh
Enter fullscreen mode Exit fullscreen mode

It'll list the files in this directory if they exist.
If a count instead is shown or no files you can move to step two

Expected Output

id_rsa.pub
id_ecdsa.pub
id_ed25519.pub
Enter fullscreen mode Exit fullscreen mode

If you already have and wish to use then, skip step 2 and continue from step 3. But if you wish to not use any already available to connect to github you can continue with step 2.

Step 2: Generating SSH Keys

Linux, Mac & Windows(Git Bash)

Type or paste the command below intor your terminal, replace your_email@example.com with your Github email address.

$ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
Enter fullscreen mode Exit fullscreen mode

Press "Enter" when prompted "Enter a file in which to save the key".
Doing this accepts the default location.

> Enter a file in which to save the key(/home/you/.ssh/id_rsa):[Press Enter]
Enter fullscreen mode Exit fullscreen mode

At the next prompt type a secure password and confirm it by typing it again on the next prompt

> Enter passphrase (empty for no passphrase): [Type a passphrase]
> Enter same passphrase again: [Type passphrase again]
Enter fullscreen mode Exit fullscreen mode

Step 3 Adding SSH key to the ssh-agent

Linux & Windows(Git Bash)

Start the ssh-agent in the background

$ eval "\$(ssh-agent -s)"
Enter fullscreen mode Exit fullscreen mode

Result: But could be a different number

 Agent pid 67068
Enter fullscreen mode Exit fullscreen mode

Add your ssh private key to the ssh-agent.

$ ssh-add ~/.ssh/id_rsa
Enter fullscreen mode Exit fullscreen mode

Mac

Start the ssh-agent in the background

$ eval $(ssh-agent -s)
Enter fullscreen mode Exit fullscreen mode

Result: But could be a different number

 Agent pid 59068
Enter fullscreen mode Exit fullscreen mode

NOTE: For macOS Sierra 10.12.2 or later
Modify your (~/.ssh/config) file to automatically load keys into the ssh-agent and store passphrases in your keychain.

  1. First check to see if your ~/.ssh/config file exists in the default location

    $ open ~/.ssh/config

If you get

[The file /Users/you/.ssh/config does not exist
Enter fullscreen mode Exit fullscreen mode

Then create the file.

$ touch ~/.ssh/config
Enter fullscreen mode Exit fullscreen mode

Open it and modify the file.

Host *
    AddKeysToAgent yes
    UseKeyChain yes
    IdentityFile ~/.ssh/id_rsa
Enter fullscreen mode Exit fullscreen mode

Add your ssh private key to the ssh-agent.

$ ssh-add ~/.ssh/id_rsa
Enter fullscreen mode Exit fullscreen mode

If for professional purposes or personal purposes, you created the key with a different name, replace id_rsa with the name of the private key file.

Step 4: Adding SSH key to your Github Account

Copy the SSH key to your clipboard
REMINDER: If your SSH key file has a different name, modify the filename to match your setup. No new line or whitespace are allowed.

MAC

$ pbcopy < ~/.ssh/id_rsa.pub
Enter fullscreen mode Exit fullscreen mode

Linux

To Check for latest drivers and update

$ sudo apt-get update

$ sudo apt-get upgrade -y
Enter fullscreen mode Exit fullscreen mode

Install xclip and copy the contents

$ sudo apt-get install xclip

$ xclip -sel clip < ~/.ssh/id_rsa.pub

Enter fullscreen mode Exit fullscreen mode




Windows


$ clip < ~/.ssh/id_rsa.pub
Enter fullscreen mode Exit fullscreen mode




General

ALL COMMANDS ARE DONE NOW.

Login your Github on a browser & Navigate to Settings

Alt Text

Select SSH and GPG keys

Alt Text

Click New SSH keys

Alt Text

In the Title field, add a descriptive label for the new key

Alt Text

Finally paste your key into the Key Field and click add

Alt Text

Now you can go back to your terminal and clone, push, pull and run every other Git command without having to repeatedly input your GITHUB details

Extra Note: When try to perform a Git command from an Editors or IDE for the first time, you might be asked to input the passphrase use in creating the SSH key.

You can either allow it once or allow it until you choose to remove the SSH Key from Github

Thanks 😘

Top comments (0)