You can find our user documentation at

Check out our new API beta site!

Page tree
Skip to end of metadata
Go to start of metadata

This document is for a previous release of cPanel & WHM. To view our latest documentation, visit our Home page.

For cPanel & WHM 11.40

(WHM >> Security Center >> Manage root's SSH Keys)


You can create a new SSH key set for use on your server. After you create the new SSH key, you must authorize the key.

How to generate a new SSH key


If you use a custom key name, after it is imported you must manually specify the SSH key. The command to manually specify the SSH key is: ssh -i /root/.ssh/key_name.

To generate a new SSH key set, perform the following steps: 

  1. Click Generate a New Key.
  2. If you wish to use a customer key name, enter the key name in the Key Name (defaults to id_dsa): text box.
  3. If you wish to use a password for the SSH key, enter the password for the new key in the Key Password text box. Confirm the password in the Password (Again) text box.
    • To use the Password Generator, click Generate Password.
  4. Select your key type.
    • DSA keys provide quicker key generation and signing times.
    • RSA keys provide quicker verification times.
  5. Select your desired key size. 

    While greater key sizes are more secure, they result in larger file sizes and slower authentication times.

  6. Click Generate Key.
  7. WHM will display the saved location of the key.

 Authorize a new SSH key

To authorize a new SSH key set for use, perform the following:

  1. Locate your new SSH key in the Public Keys table (Home >> Security Center >> Manage root's SSH Keys).
  2. Click Manage Authorization in the appropriate column.
  3. Click Authorize to allow the server to use the new key.

You must authorize the SSH key for the key to function.

Additional information

To view the new public SSH key, click the View/Download Key link in the Public Keys table.

To use the key, copy the public SSH key to the machine from which you wish to remotely access the web server.