Generating SSH Keys (Linux / Mac)

February 13, 2017

Follow these steps to setup a new SSH public key for use with The Storehouse.  To access your project data, you'll have to have a key setup.

Check For An Existing Key

If you already have a SSH key generated, you'll just have to copy it into The Storehouse to use it.  You might already have a key if you've used SSH in the past.

To check, run:

cat ~/.ssh/id_rsa.pub

If you see a message saying "No such file or directory," you don't have a key setup and you should follow the rest of this guide.  If you see output that starts with ssh-rsa, jump to the "Setting Up A New Key" section.

Generating A New Key

If you don't have a key or want to overwrite your existing key, generating a new one is very simple.  Simply run"

ssh-keygen

It will ask about a few different options, but the defaults are OK in most cases.  It will then ask for an optional pass phrase.  The pass phrase is required to use the key and helps protect against someone getting a copy of your key and using it without your knowledge.  Setting a pass phrase is recommended, but not required.

Setting Up A New Key

Once your key is generated, you'll have to upload it to The Storehouse in order to make use of it.  To do this, run the command:

cat ~/.ssh/id_rsa.pub

You'll see output that starts with ssh-rsa and ends with a comment, usually your_name@computer_name.  Copy all of the contents by right clicking, and navigate to the SSH Keys page on The Storehouse.  Create a new key and paste the key into the key contents field.  You can enter a name for your reference in the future if you'd like.

Once saved, you'll be able to use SSH to copy and upload project data.