/ docs / github / 1_prerequisites_github_ubuntu.md
1_prerequisites_github_ubuntu.md
 1  ## 📘 `1_prerequisites_github_ubuntu.md`
 2  
 3  ### 📌 Purpose
 4  
 5  Prepare your Ubuntu system to create and work with remote GitHub repositories using SSH.
 6  
 7  ---
 8  
 9  ### ✅ System Requirements
10  
11  * **Install Git**
12  
13  ```bash
14  sudo apt update
15  sudo apt install git -y
16  ```
17  
18  * **Create a GitHub account**
19    👉 [https://github.com/join](https://github.com/join)
20  
21  * **Set your Git identity**
22  
23  ```bash
24  git config --global user.name "Your Name"
25  git config --global user.email "your_email@example.com"
26  ```
27  
28  * **Generate an SSH key (if not already present)**
29  
30  ```bash
31  ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
32  eval "$(ssh-agent -s)"
33  ssh-add ~/.ssh/id_rsa
34  ```
35  
36  * **Add your SSH public key to GitHub**
37  
38  ```bash
39  cat ~/.ssh/id_rsa.pub
40  ```
41  
42  🔗 Copy the output and paste it at:
43  GitHub → Settings → SSH and GPG keys → *New SSH key*
44  
45  * **Test the connection**
46  
47  ```bash
48  ssh -T git@github.com
49  ```
50  
51  You should see:
52  
53  > "Hi `your-username`! You've successfully authenticated..."
54  
55  ---