Bootstrap: GitHub access setup for new team members

github-bootstrap.md

GitHub Access Bootstrap

Get GitHub access set up so you can clone team repos.

Prerequisite: Set up KeePassXC first → https://gist.github.com/waynemsmith/a05fc50813025265ff6cbbb338b365d6

---

1. Install GitHub CLI

Fedora:

sudo dnf install -y gh

Ubuntu:

sudo apt install gh

2. Configure Git

git config --global user.name "Your Full Name"
git config --global user.email "[email protected]"
git config --global init.defaultBranch main

3. Generate GitHub SSH Key

Follow the same policy as other SSH keys:

ssh-keygen -t ed25519 -C "{username}-{machine}-github" -f ~/.ssh/id_github

Example:

ssh-keygen -t ed25519 -C "khurrams-probook-github" -f ~/.ssh/id_github

Passphrase requirements:

• 4-5 random words (e.g., purple elephant dancing Tuesday)
• Generate in KeePassXC: Tools → Password Generator → Passphrase tab
• Store in KeePassXC (personal.kdbx) as SSH - id_github

4. Add Key to GitHub

gh auth login

Select:

• GitHub.com
• SSH
• Use existing SSH key → select ~/.ssh/id_github.pub
• Authenticate via browser

5. Configure SSH to Use Key

Add to ~/.ssh/config:

Host github.com
    HostName github.com
    User git
    IdentityFile ~/.ssh/id_github
    IdentitiesOnly yes

6. Verify Access

ssh-add ~/.ssh/id_github
gh auth status
ssh -T [email protected]

Should show: Hi {username}! You've successfully authenticated...

7. Clone Team Repos

mkdir -p ~/github ~/g
git clone [email protected]:Concurrent-Systems/deskguard.git ~/github/deskguard
git clone --recursive [email protected]:Concurrent-Systems/infra.git ~/g/infra

8. Continue Setup

Full workstation setup guide: https://github.com/Concurrent-Systems/infra/blob/main/docs/workstation-setup.md