Skip to content

Commit f31e6ec

Browse files
authored
Enhanced setup instructions with illustrative screenshots for improved clarity.
This commit adds screenshots at key steps in the setup instructions to provide visual aids for users. The screenshots were captured following the provided instructions to ensure accuracy. This improvement aims to make the setup process more accessible and user-friendly, particularly for beginners who may find visual guidance helpful. Please review and provide feedback if needed.
1 parent f68c9b1 commit f31e6ec

File tree

1 file changed

+39
-11
lines changed

1 file changed

+39
-11
lines changed

github.md

Lines changed: 39 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -18,23 +18,51 @@ But you can still use `check50` and `submit50`! You just need to log in a bit di
1818
## SSH
1919

2020
1. Open a terminal window, if not open already, within [Visual Studio Code](/code/), [CS50 IDE](/ide/index), [CS50 Sandbox](/sandbox/), or [CS50 Lab](/lab/).
21-
1. Execute `ssh-keygen`. When prompted to "save the key," just hit Enter, without typing anything.
22-
1. You'll then be prompted for a "passphrase" (i.e., password). If you only use your GitHub account for CS50, no need to input a passphrase; just hit Enter. Otherwise, input a passphrase (that you won't forget!), then hit Enter, then input it again, then hit Enter again. For security's sake, you won't see what you type. You'll then see a "randomart image" that you can ignore.
23-
1. Execute `cat ~/.ssh/id_rsa.pub`. You'll then see your "public key," multiple lines of seemingly random text. Highlight and copy all of those lines, starting with `ssh-rsa` to the end. **But don't highlight your terminal window's prompts (which contain `$`) before or after those lines.**
24-
1. Visit [https://github.com/settings/keys](https://github.com/settings/keys), logging in with your GitHub username and password as usual. Don't use the passphrase you just created, if any.
25-
1. Click **New SSH Key**.
26-
1. Paste your public key into the text box under **Key**. Optionally input a title under **Title** (e.g., `CS50`).
27-
1. Click **Add SSH Key**.
28-
1. Execute `ssh -T [email protected] -p 443`.
29-
1. Enter "yes" and press enter if you see the following prompt (the IP address might be different):
21+
22+
![image](https://github.com/init6-rj/cs50.readthedocs.io/assets/84857474/41125327-ecfe-4b49-b776-dc9ecbee3f83)
23+
24+
25+
2. Execute `ssh-keygen`. When prompted to "save the key," just hit Enter, without typing anything.
26+
27+
3. You'll then be prompted for a "passphrase" (i.e., password). If you only use your GitHub account for CS50, no need to input a passphrase; just hit Enter. Otherwise, input a passphrase (that you won't forget!), then hit Enter, then input it again, then hit Enter again. For security's sake, you won't see what you type. You'll then see a "randomart image" that you can ignore.
28+
29+
![image](https://github.com/init6-rj/cs50.readthedocs.io/assets/84857474/f2878e7c-fa61-4dd1-a070-a96209c79517)
30+
31+
32+
4. Execute `cat ~/.ssh/id_rsa.pub`. You'll then see your "public key," multiple lines of seemingly random text. Highlight and copy all of those lines, starting with `ssh-rsa` to the end. **But don't highlight your terminal window's prompts (which contain `$`) before or after those lines.**
33+
34+
![image](https://github.com/init6-rj/cs50.readthedocs.io/assets/84857474/b9ff868f-7bca-47cb-80fa-f674a1fa6fd9)
35+
36+
37+
5. Visit [https://github.com/settings/keys](https://github.com/settings/keys), logging in with your GitHub username and password as usual. Don't use the passphrase you just created, if any.
38+
39+
![image](https://github.com/init6-rj/cs50.readthedocs.io/assets/84857474/f1a880b2-818f-4f71-ab70-62ee66c7d35c)
40+
41+
42+
6. Click **New SSH Key**.
43+
44+
![image](https://github.com/init6-rj/cs50.readthedocs.io/assets/84857474/1efc9a59-251c-45e0-adb5-a0dc354f5d20)
45+
46+
47+
7. Paste your public key into the text box under **Key**. Optionally input a title under **Title** (e.g., `CS50`).
48+
8. Click **Add SSH Key**.
49+
50+
![image](https://github.com/init6-rj/cs50.readthedocs.io/assets/84857474/a6573592-c9fc-4915-988e-56670afd6d4d)
51+
52+
53+
9. Execute `ssh -T [email protected] -p 443`.
54+
10. Enter "yes" and press enter if you see the following prompt (the IP address might be different):
3055
```
3156
The authenticity of host '[ssh.github.com]:443 ([140.82.113.35]:443)' can't be established.
3257
ED25519 key fingerprint is SHA256:7KMZvJiITZ+HbOyqjKJV2AeC5As3GSZES5abcd1NIe4.
3358
This key is not known by any other names
3459
Are you sure you want to continue connecting (yes/no/[fingerprint])?
3560
```
36-
1. If you input a "passphrase" (i.e., password) earlier, enter the passphrase and press Enter when you see the following prompt `"Enter passphrase for key 'home/ubuntu/.ssh/id_rsa':"`
37-
1. You should be greeted with `"Hi USERNAME! You've successfully authenticated, but GitHub does not provide shell access."` If you don't see that, review the above steps to verify you didn't skip something.
61+
11. If you input a "passphrase" (i.e., password) earlier, enter the passphrase and press Enter when you see the following prompt `"Enter passphrase for key 'home/ubuntu/.ssh/id_rsa':"`
62+
12. You should be greeted with `"Hi USERNAME! You've successfully authenticated, but GitHub does not provide shell access."` If you don't see that, review the above steps to verify you didn't skip something.
63+
64+
![image](https://github.com/init6-rj/cs50.readthedocs.io/assets/84857474/5ba967f4-5fe3-4276-bd43-4aa419b57f36)
65+
3866
3967
You should now be able to use `check50` and `submit50` (and `git`) without GitHub username and password. But if you created a passphrase, you might still be prompted for that.
4068

0 commit comments

Comments
 (0)