Log in with an SSH private key on Linux and Mac

  • Last updated on: 2016-06-07
  • Authored by: Brint Ohearn

This example demonstrates how to use a private key to log in to a Linux server by using a private key by using a Terminal session on OS X. However, you can follow the same process to use a private key when using any terminal software on Linux.

Note: For information about using SSH private keys on Windows operating systems, see Logging in with an SSH Private Key on Windows.

Prerequisites

To complete this process, you need the following software applications:

  • ssh - SSH client software is installed on your Linux or OS X operating system by default
  • Your favorite text editor. This example uses the vim text editor.

Log in with a private key

  1. Using a text editor, create a file in which to store your private key. This example uses the file deployment_key.txt.

  2. To edit the file in vim, type the following command

       vim deployment_key.txt
    
  3. After the editor starts, press i to turn on insert mode.

  4. Paste the private key into the file. Be sure to include the BEGIN and END lines.

  5. To save your changes, press Esc.

  6. Type :wq to write the file and return to the command line.

  7. Run the following command to change the file permissions to 600 to secure the key. You can also set them to 400. This step is required:

       chmod 600 deployment_key.txt
    
  8. Use the key to log in to the SSH client as shown in the following example, which loads the key in file deployment_key.txt, and logs in as user demo,to IP 192.237.248.66:

       ssh -i deployment_key.txt demo@192.237.248.66
    
  9. When the prompt to confirm the connection request is displayed, type yes and then press Enter.

  10. If your SSH key requires a password, enter it when prompted to complete the connection.

Continue the conversation in the Rackspace Community.