Skip to content

Commit 3fd4765

Browse files
authored
Further edits to SSH instructions (#84)
* Update 5-git.md * Add files via upload * Delete settings.png * Update image Use a smaller size.
1 parent e61ca14 commit 3fd4765

File tree

3 files changed

+33
-33
lines changed

3 files changed

+33
-33
lines changed

images/settings.jpg

118 KB
Loading

images/settings.png

-137 KB
Binary file not shown.

system-setup/5-git.md

Lines changed: 33 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -12,25 +12,25 @@ In order to use Git locally in a secure manner, we need to connect our computer
1212

1313
[GitHub Instructions: Generate SSH Key](https://docs.github.com/en/github/authenticating-to-github/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)
1414

15-
1. Create an "SSH Key"
15+
1. Create an "SSH Key":
1616

17-
- Head to your terminal and enter the following command (using the email address you sign into GitHub with)
17+
- Head to your terminal and enter the following command (using the email address you sign in to GitHub with):
1818

1919
```bash
2020
ssh-keygen -t rsa -b 4096 -C "[email protected]"
2121
```
2222

23-
- This will prompt you for a file location. Just accept the default
23+
- This will prompt you for a file location. Just accept the default.
2424

25-
```bash
25+
```
2626
Enter file in which to save the key (/Users/yourname/.ssh/id_rsa):
2727
```
2828

2929
- It will then prompt you for a password to lock down this file. Enter one you can remember.
3030

3131
> Note that you are free to leave this blank if you want to avoid typing passwords every time you use git. It's fine, although not terribly secure if someone gets ahold of your laptop
3232
33-
```bash
33+
```
3434
Enter passphrase (empty for no passphrase):
3535
```
3636
@@ -61,15 +61,15 @@ In order to use Git locally in a secure manner, we need to connect our computer
6161
+----[SHA256]-----+
6262
```
6363
64-
1. Give that key to GitHub
64+
1. Give that key to GitHub
6565
66-
- Type this command to see your new key:
66+
- Type this command to see your new key:
6767
6868
```bash
6969
cat ~/.ssh/id_rsa.pub
7070
```
7171
72-
- It'll look like a bunch of random letters, like this:
72+
- It'll look like a bunch of random letters, like this:
7373
7474
```text
7575
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQC1PqLEQoHNtq0Nx0IyIKQxXj91oSdTU0F2LA5FnCRPSJLBplzBtlkZdG9JLX
@@ -84,28 +84,28 @@ In order to use Git locally in a secure manner, we need to connect our computer
8484
8585
```
8686
87-
- You'll need to copy that and paste it into GitHub. There are 3 ways to do this
88-
89-
- Mac Users: Run `pbcopy < ~/.ssh/id_rsa.pub` to copy key to clipboard.
90-
- Linux / Windows Users can use `xclip` to do this
91-
- `sudo apt-get install xclip` installs xclip
92-
- `xclip -selection clipboard < ~/.ssh/id_rsa.pub` to copy key to clipboard
93-
- Or, you can do this the old fashioned way and Highlight the text and copy it to your clipboard
94-
- Note: Copy all of it, from the `ssh-rsa` to your email address at the end
95-
96-
- Now that you have this in your clip board, get it into GitHub ...
97-
- Login to your GitHub Account
98-
- Go to your settings page
99-
- Click the down arrow next your icon on the top right and choose **"Settings"**
100-
![Settings](../images/settings.png)
101-
- From the settings window, choose the **"SSH and GPG Keys"** menu option
87+
- You'll need to copy that and paste it into GitHub. There are 3 ways to do this
88+
89+
- Mac Users: Run `pbcopy < ~/.ssh/id_rsa.pub` to copy key to clipboard.
90+
- Linux / Windows Users can use `xclip` to do this
91+
- `sudo apt-get install xclip` installs xclip
92+
- `xclip -selection clipboard < ~/.ssh/id_rsa.pub` to copy key to clipboard
93+
- Or, you can do this the old fashioned way and Highlight the text and copy it to your clipboard
94+
- Note: Copy all of it, from the `ssh-rsa` to your email address at the end
95+
96+
- Now that you have this in your clip board, get it into GitHub ...
97+
- Login to your GitHub Account
98+
- Go to your settings page
99+
- Click the down arrow next your icon on the top right and choose **"Settings"**
100+
![Settings](../images/settings.jpg)
101+
- From the settings window, choose the **"SSH and GPG Keys"** menu option
102102
![Settings](../images/keys.png)
103-
- Click the green button labeled "New SSH Key"
104-
- On the next screen you'll see 2 inputs
105-
- In the first one, give you key a name, like "My Computer"
106-
- In the second box, paste in the key you copied in the previous step
107-
- Press the **Add SSH Key** button
103+
- Click the green button labeled "New SSH Key"
104+
- On the next screen you'll see 2 inputs
108105
![Add Key](../images/add-key.png)
106+
- Title: Give your key a name, like "My Computer"
107+
- Key: Paste in the key you copied in the previous step
108+
- Press the **Add SSH Key** button
109109
110110
1. Add the key to your computer's **ssh-agent**
111111
@@ -119,7 +119,7 @@ In order to use Git locally in a secure manner, we need to connect our computer
119119
120120
- If it is, you should see output that looks like this:
121121
122-
```bash
122+
```
123123
Agent pid 95727
124124
```
125125
@@ -141,7 +141,7 @@ In order to use Git locally in a secure manner, we need to connect our computer
141141
142142
- You should see a success message like this:
143143
144-
```bash
144+
```
145145
Identity added: /Users/johncokos/.ssh/id_rsa ([email protected])
146146
```
147147
@@ -161,14 +161,14 @@ In order to use Git locally in a secure manner, we need to connect our computer
161161
162162
1. Test it out!
163163
164-
- Try a test connection to GitHub:
164+
- Try a test connection to GitHub:
165165
166166
```bash
167167
168168
```
169169
170-
- If you get a warning about authenticity of host enter `yes` to continue connecting.
171-
- You should get confirmation that looks something like this ... congratulations!
170+
- If you get a warning about authenticity of host enter `yes` to continue connecting.
171+
- You should get confirmation that looks something like this ... congratulations!
172172
173173
```bash
174174
Hi yourname! You've successfully authenticated, but GitHub does not provide shell access.

0 commit comments

Comments
 (0)