Git Intro Workshop
🛠️ Pre-Workshop Setup Guide: VScode + Git + GitHub (HTTPS Authentication)
Welcome to the Git Workshop! Follow these steps before the session to make sure you’re ready to use Git and GitHub with HTTPS authentication.
✅ Prerequisites
Make sure you have:
🔐 Step 1: Set Up Git Credential Storage
To avoid entering your credentials every time, configure Git to store them securely.
🔹 Windows
git config --global credential.helper manager-core
🔹 macOS
git config --global credential.helper osxkeychain
🔹 Linux
git config --global credential.helper cache
💡 You only need to run this once per system.
🧾 Step 2: Generate a Personal Access Token (PAT)
- Visit: https://github.com/settings/tokens
- Click “Generate new token (classic)”
- Fill in the form:
- Note:
Git Workshop Token
- Expiration:
90 days
- Scopes:
- ✅
repo
– full access to GitHub repositories - ✅
workflow
– allows triggering and viewing GitHub Actions
- ✅
- Note:
- Click Generate token
- Copy the token now — you won’t be able to see it again.
➤ Save it in a safe place on your computer, like a plain text file:
my-github-token.txt
☑️ Step 3: Test Your HTTPS Setup
Run the following command to verify that Git can connect to GitHub using HTTPS:
git ls-remote https://github.com/github/gitignore.git
You will be prompted for your GitHub username and your Personal Access Token as the password.
- ✅ If it returns a list of references (e.g.
refs/heads/main
), you’re ready. - ❌ If authentication fails, double-check that your token has the correct scopes and hasn’t expired.
🧑💻 Step 4 (Optional): Set Your Git Identity
Set your name and email so commits are properly attributed.
git config --global user.name "Your Full Name"
git config --global user.email "you@example.com"
✅ Final Checklist
You’re now ready for the workshop!