Skip to main content

Error: Unknown key type

This error means that the SSH key type you used was unrecognized or is unsupported by your SSH client.

Platform navigation

About the unknown key type error

When you generate a new SSH key, you may receive an unknown key type error if your SSH client does not support the key type that you specify.

To solve this issue on macOS, you can update your SSH client or install a new SSH client.

Prerequisites

You must have Homebrew installed. For more information, see the installation guide in the Homebrew documentation.

Solving the issue

Warning: If you install OpenSSH, your computer will not be able to retrieve passphrases that are stored in the Apple keychain. You will need to enter your passphrase or interact with your hardware security key every time you authenticate with SSH to GitHub or another web service.

If you remove OpenSSH, the passphrases that are stored in your keychain will once again be retrievable. You can remove OpenSSH by entering the command brew uninstall openssh in Terminal.

  1. Open Terminal.
  2. Enter the command brew install openssh.
  3. Quit and relaunch Terminal.
  4. Try the procedure for generating a new SSH key again. For more information, see "Generating a new SSH key and adding it to the ssh-agent."
To solve this issue on Linux, use the package manager for your Linux distribution to install a new version of OpenSSH, or compile a new version from source. If you install a different version of OpenSSH, the ability of other applications to authenticate via SSH may be affected. For more information, review the documentation for your distribution.