+
+
+{% capture mac-content-add %}
+1. Start the `ssh-agent` in the background using the command `eval "$(ssh-agent -s)"`. You will get the agent process ID in return.
+
+ ```none
+ eval "$(ssh-agent -s)"
+ Agent pid 59566
+ ```
+
+2. On macOS Sierra 10.12.2 or newer, modify your
+`~/.ssh/config` file to automatically load keys into the `ssh-agent` and store
+passphrases in your keychain.
+
+ ```none
+ Host *
+ AddKeysToAgent yes
+ UseKeychain yes
+ IdentityFile ~/.ssh/id_rsa
+ ```
+
+3. Add your SSH private key to the ssh-agent, using the default macOS `ssh-add` command.
+
+ ```none
+ $ ssh-add -K ~/.ssh/id_rsa
+ ```
+
+ If you created your key with a different name or have an existing key
+ with a different name, replace `id_rsa` in the command with the
+ name of your private key file.
+
+{% endcapture %}
+{{ mac-content-add | markdownify }}
+
+
+
+
+{% capture win-content-add %}
+
+1. Start the `ssh-agent` in the background.
+
+ ```none
+ eval "$(ssh-agent -s)"
+ Agent pid 59566
+ ```
+
+2. Add your SSH private key to the ssh-agent.
+
+ ```none
+ $ ssh-add -K ~/.ssh/id_rsa
+ ```
+
+ If you created your key with a different name or have an existing key
+ with a different name, replace `id_rsa` in the command with the
+ name of your private key file.
+
+{% endcapture %}
+{{ win-content-add | markdownify }}
+
+
+
+
+{% capture linux-content-add %}
+
+1. Start the `ssh-agent` in the background.
+
+ ```none
+ eval "$(ssh-agent -s)"
+ Agent pid 59566
+ ```
+
+2. Add your SSH private key to the ssh-agent.
+
+ ```none
+ $ ssh-add -K ~/.ssh/id_rsa
+ ```
+
+ If you created your key with a different name or have an existing key
+ with a different name, replace `id_rsa` in the command with the
+ name of your private key file.
+
+{% endcapture %}
+{{ linux-content-add | markdownify }}
+
+
+
+
+{% capture mac-content-copy %}
+
+Copy the public SSH key to your clipboard.
+
+```none
+$ pbcopy < ~/.ssh/id_rsa.pub
+```
+
+If your SSH key file has a different name than the example code, modify the
+filename to match your current setup.
+
+>**Tip:** If you don't have `pbcopy`, you navigate to the hidden `.ssh`
+folder, open the file in a text editor, and copy it to your clipboard.
+For example: `$ atom ~/.ssh/id_rsa.pub`
+
+{% endcapture %}
+{{ mac-content-copy | markdownify }}
+
+
+
+
+{% capture win-content-copy %}
+
+Copy the public SSH key to your clipboard.
+
+```none
+$ clip < ~/.ssh/id_rsa.pub
+```
+
+If your SSH key file has a different name than the example code, modify the
+filename to match your current setup.
+
+>**Tip:** If `clip` doesn't work, navigate the hidden `.ssh`
+folder, open the file in a text editor, and copy it to your clipboard.
+For example: `$ notepad ~/.ssh/id_rsa.pub`
+
+{% endcapture %}
+{{ win-content-copy | markdownify }}
+
+
+
+
+{% capture linux-content-copy %}
+
+If you don't already have it, install `xclip`. (The example uses `apt-get` to install, but you might want to use another package installer like `yum`.)
+
+```none
+$ sudo apt-get install xclip
+```
+
+Copy the SSH key to your clipboard.
+
+```none
+$ xclip -sel clip < ~/.ssh/id_rsa.pub
+```
+
+>**Tip:** If you `xclip` isn't working, navigate to hidden `.ssh` folder,
+open the file in a text editor, and copy it to your clipboard.
+For example: `$ vi ~/.ssh/id_rsa.pub`
+
+{% endcapture %}
+{{ linux-content-copy | markdownify }}
+
+
+
+
+{% capture mac-content-find %}
+
+1. Open a command-line terminal.
+
+ ```none
+ $ ls -al ~/.ssh
+ ```
+
+ This lists files in your `.ssh` directory.
+
+2. Check to see if you already have a SSH keys you can use.
+
+ Default file names for public keys are:
+
+ * id_dsa.pub
+ * id_ecdsa.pub
+ * id_ed25519.pub
+ * id_rsa.pub
+
+ Here are example results showing a public and private key pair with the default names:
+
+ ```none
+ drwx------ 8 me staff 272 Mar 27 14:04 .
+ drwxr-xr-x+ 69 me staff 2346 Apr 7 10:03 ..
+ -rw-r--r-- 1 me staff 420 Mar 27 14:04 config
+ -rw------- 1 me staff 3326 Mar 27 14:01 id_rsa
+ -rw-r--r-- 1 me staff 752 Mar 27 14:01 id_rsa.pub
+ ```
+
+ The file `id_rsa` contains the private key which resides on the local machine, and `id_rsa.pub` is the public key we can provide to a remote account.
+
+{% endcapture %}
+{{ mac-content-find | markdownify }}
+
+
+
+
+{% capture win-content-find %}
+
+1. Open Git Bash.
+
+ ```none
+ $ ls -al ~/.ssh
+ ```
+
+ This will list files in your `.ssh` directory.
+
+2. Check to see if you already have SSH keys you can use.
+
+ Default file names for public keys are:
+
+ * id_dsa.pub
+ * id_ecdsa.pub
+ * id_ed25519.pub
+ * id_rsa.pub
+
+ Here are example results showing a public and private key pair with the default names:
+
+ ```none
+ drwx------ 8 me staff 272 Mar 27 14:04 .
+ drwxr-xr-x+ 69 me staff 2346 Apr 7 10:03 ..
+ -rw-r--r-- 1 me staff 420 Mar 27 14:04 config
+ -rw------- 1 me staff 3326 Mar 27 14:01 id_rsa
+ -rw-r--r-- 1 me staff 752 Mar 27 14:01 id_rsa.pub
+ ```
+
+ The file `id_rsa` contains the private key which resides on the local machine, and `id_rsa.pub` is the public key we can provide to a remote account.
+
+{% endcapture %}
+{{ win-content-find | markdownify }}
+
+
+
+
+{% capture linux-content-find %}
+
+1. Open a command-line terminal.
+
+ ```none
+ $ ls -al ~/.ssh
+ ```
+
+ This will list files in your `.ssh` directory.
+
+2. Check to see if you already have a SSH keys you can use.
+
+ Default file names for public keys are:
+
+ * id_dsa.pub
+ * id_ecdsa.pub
+ * id_ed25519.pub
+ * id_rsa.pub
+
+ Here are example results showing a public and private key pair with the default names:
+
+ ```none
+ drwx------ 8 me staff 272 Mar 27 14:04 .
+ drwxr-xr-x+ 69 me staff 2346 Apr 7 10:03 ..
+ -rw-r--r-- 1 me staff 420 Mar 27 14:04 config
+ -rw------- 1 me staff 3326 Mar 27 14:01 id_rsa
+ -rw-r--r-- 1 me staff 752 Mar 27 14:01 id_rsa.pub
+ ```
+
+ The file `id_rsa` contains the private key which resides on the local machine, and `id_rsa.pub` is the public key we can provide to a remote account.
+
+{% endcapture %}
+{{ linux-content-find | markdownify }}
+
+
+
+
+{% capture mac-content-gen %}
+1. Open a command-line terminal.
+
+2. Paste the text below, substituting in your GitHub email address.
+
+ ```none
+ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
+ ```
+
+ This creates a new SSH key, using the provided email as a label.
+
+ ```none
+ Generating public/private rsa key pair.
+ ```
+
+3. When prompted with "Enter a file in which to save the key", press the Return key (Enter) to accept the default location.
+
+ ```none
+ Enter a file in which to save the key (/Users/you/.ssh/id_rsa):
+ ```
+
+4. At the prompt, type a secure passphrase, and re-enter as prompted.
+
+ ```none
+ Enter passphrase (empty for no passphrase):
+ Enter same passphrase again:
+ ```
+{% endcapture %}
+{{ mac-content-gen | markdownify }}
+
+
+
+
+{% capture win-content-gen %}
+1. Open Git Bash.
+
+2. Paste the text below, substituting in your GitHub email address.
+
+ ```none
+ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
+ ```
+
+ This creates a new SSH key, using the provided email as a label.
+
+ ```none
+ Generating public/private rsa key pair.
+ ```
+
+3. When prompted with "Enter a file in which to save the key", press the Return key (Enter) to accept the default location.
+
+ ```none
+ Enter a file in which to save the key (c/Users/you/.ssh/id_rsa):
+ ```
+
+4. At the prompt, type a secure passphrase, and re-enter as prompted.
+
+ ```none
+ Enter passphrase (empty for no passphrase):
+ Enter same passphrase again:
+ ```
+{% endcapture %}
+{{ win-content-gen | markdownify }}
+
+
+
+
+{% capture linux-content-gen %}
+1. Open a command-line terminal.
+
+2. Paste the text below, substituting in your GitHub email address.
+
+ ```none
+ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
+ ```
+
+ This creates a new SSH key, using the provided email as a label.
+
+ ```none
+ Generating public/private rsa key pair.
+ ```
+
+3. When prompted with "Enter a file in which to save the key", press the Return key (Enter) to accept the default location.
+
+ ```none
+ Enter a file in which to save the key (/home/you/.ssh/id_rsa):
+ ```
+
+4. At the prompt, type a secure passphrase, and re-enter as prompted.
+
+ ```none
+ Enter passphrase (empty for no passphrase):
+ Enter same passphrase again:
+ ```
+{% endcapture %}
+{{ linux-content-gen | markdownify }}
+
+