docs/content/github/authenticating-to-github/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account.md

title, intro, redirect_from, versions, topics

title	intro	redirect_from	versions	topics
Adding a new SSH key to your GitHub account	To configure your {% data variables.product.product_name %} account to use your new (or existing) SSH key, you'll also need to add it to your {% data variables.product.product_name %} account.	/articles/adding-a-new-ssh-key-to-your-github-account /github/authenticating-to-github/adding-a-new-ssh-key-to-your-github-account	free-pro-team enterprise-server github-ae * * *	SSH

Before adding a new SSH key to your {% data variables.product.product_name %} account, you should have:

• Checked for existing SSH keys
• Generating a new SSH key and adding it to the ssh-agent

After adding a new SSH key to your {% data variables.product.product_name %} account, you can reconfigure any local repositories to use SSH. For more information, see "Switching remote URLs from HTTPS to SSH."

{% data reusables.ssh.dsa-support %}

{% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.19" %} {% tip %}

Tip: You can also add an SSH key using the {% data variables.product.prodname_cli %}. For more information, see "gh ssh-key add" in the {% data variables.product.prodname_cli %} documentation.

{% endtip %} {% endif %}

{% mac %}

1. Copy the SSH public key to your clipboard.

If your SSH public key file has a different name than the example code, modify the filename to match your current setup. When copying your key, don't add any newlines or whitespace.

$ pbcopy < ~/.ssh/id_ed25519.pub
# Copies the contents of the id_ed25519.pub file to your clipboard

{% tip %}

Tip: If pbcopy isn't working, you can locate the hidden .ssh folder, open the file in your favorite text editor, and copy it to your clipboard.

{% endtip %}

{% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} 4. Click New SSH key or Add SSH key. 5. In the "Title" field, add a descriptive label for the new key. For example, if you're using a personal Mac, you might call this key "Personal MacBook Air". 6. Paste your key into the "Key" field. 7. Click Add SSH key. {% data reusables.user_settings.sudo-mode-popup %}

{% endmac %}

{% windows %}

1. Copy the SSH public key to your clipboard.

If your SSH public key file has a different name than the example code, modify the filename to match your current setup. When copying your key, don't add any newlines or whitespace.

$ clip < ~/.ssh/id_ed25519.pub
# Copies the contents of the id_ed25519.pub file to your clipboard

{% tip %}

Tip: If clip isn't working, you can locate the hidden .ssh folder, open the file in your favorite text editor, and copy it to your clipboard.

{% endtip %}

{% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} 4. Click New SSH key or Add SSH key. 5. In the "Title" field, add a descriptive label for the new key. For example, if you're using a personal Mac, you might call this key "Personal MacBook Air". 6. Paste your key into the "Key" field. 7. Click Add SSH key. 8. If prompted, confirm your {% data variables.product.product_name %} password.

{% endwindows %}

{% linux %}

1. Copy the SSH public key to your clipboard.

If your SSH public key file has a different name than the example code, modify the filename to match your current setup. When copying your key, don't add any newlines or whitespace.

$ sudo apt-get update
$ sudo apt-get install xclip
# Downloads and installs xclip. If you don't have `apt-get`, you might need to use another installer (like `yum`)

$ xclip -selection clipboard < ~/.ssh/id_ed25519.pub
# Copies the contents of the id_ed25519.pub file to your clipboard

{% tip %}

Tip: If xclip isn't working, you can locate the hidden .ssh folder, open the file in your favorite text editor, and copy it to your clipboard.

{% endtip %}

{% data reusables.user_settings.access_settings %} {% data reusables.user_settings.ssh %} 4. Click New SSH key or Add SSH key. 5. In the "Title" field, add a descriptive label for the new key. For example, if you're using a personal Mac, you might call this key "Personal MacBook Air". 6. Paste your key into the "Key" field. 7. Click Add SSH key. 8. If prompted, confirm your {% data variables.product.product_name %} password.

{% endlinux %}

{% if currentVersion == "free-pro-team@latest" %}

Further reading

• "Authorizing an SSH key for use with SAML single sign-on" {% endif %}