This is the guide for setting up Git on Windows. There is also a guide for OS X.
Using Git can be intimidating at first, but once you get past the initial learning curve you'll wonder how you ever worked without it.
After reading it, you should be familiar with:
- Install Git
- Generate a SSH Key
- Add it to your Pagoda Box account
Download and Install Git
If you're new to Git, here are some educational resources:
Download and install the latest version of Git.
During installation, most of the defalut values are sufficient but we recommend selecting the option to run Git from the Command Prompt because this will allow Git and the Pagoda Gem to work in the same environment.
Once you've installed Git you need to set up your SSH key and you can do that in the Git Bash or Git GUI, both of which came with your new installation of Git
Set Up SSH Keys Using the Git GUI
We use SSH keys to establish a secure connection between your computer and Pagoda Box.
Open the Git GUI
Click Help > Show SSH Key
Click Generate Key
Enter a password if you so desire
Congratulations, you have generated an SSH key
Also, you can directly copy the key from here. You'll need that in the next step.
Set Up SSH Keys Using the Git Bash
Another way to create an SSH key is to use the Git Bash. If you've already created a key using the Git GUI then you can skip down to the next section.
We use SSH keys to establish a secure connection between your computer and Pagoda Box.
Check for SSH keys.
Git BashCheck for Existing SSH Keys
If you have an existing ssh key pair, skip to the next section. Otherwise continue to step 2.
Generate a new SSH key.
To generate a new SSH key, enter the code below. We want the default settings so when asked to enter a file in which to save the key, just press enter.
Git BashGenerate New SSH Key Pair
Now you need to enter a passphrase.
Git BashEnter Passphrase
Which should give you something like this:
Git BashKey Randomart
Add SSH Key to Pagoda
Pagoda Box Account Settings
Log into your Pagoda Box account. Click Account > Add a new SSH Key
Key Name
Give your key a name for your own reference.
Copy & Paste Public Key
If you used the Git GUI then you should already have copied your public key so go ahead and paste it in the "Key" field.
If you used the Git Bash then you need to enter this command:
Git BashCopy SSH Key
This will copy your key into the clipboard so all you need to do is paste it in the "Key" field. Then click "Create Key".
Congratulations! You have successfully added your SSH key to Pagoda Box.
