the_order/docs/GITHUB_SETUP.md

GitHub Authentication Setup

Current Status

✅ Commit ready to push: 2633de4 feat(eresidency): Complete eResidency service implementation ✅ SSH key generated: ~/.ssh/id_ed25519 ✅ Remote configured: git@github.com:Order-of-Hospitallers/the-order-monorepo.git ⚠️ Push blocked: SSH key needs to be added to GitHub

Your SSH Public Key

ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGb+gFevwMFw/Li1JLyIvpYZ4O6/f1KHutekqtPapY/l defi@defi-oracle.io

Quick Setup (SSH - Recommended)

1. Copy your SSH public key:

   cat ~/.ssh/id_ed25519.pub
   

2. Add to GitHub:

   • Visit: https://github.com/settings/keys
   • Click "New SSH key"
   • Title: WSL2 - the-order-monorepo
   • Paste the public key
   • Click "Add SSH key"

3. Test connection:

   ssh -T git@github.com
   

   You should see: Hi defiQUG! You've successfully authenticated...

4. Push your commit:

   git push
   

   Or use the script:

   ./scripts/push-to-github.sh
   

Alternative: Personal Access Token (HTTPS)

If you prefer HTTPS:

1. Create a Personal Access Token:

   • Visit: https://github.com/settings/tokens
   • Click "Generate new token (classic)"
   • Select repo scope
   • Generate and copy the token

2. Configure credential helper:

   git config --global credential.helper store
   

3. Update remote URL:

   git remote set-url origin https://github.com/Order-of-Hospitallers/the-order-monorepo.git
   

4. Push (enter token as password):

   git push
   Username: defiQUG
   Password: <paste-your-token-here>
   

Verification

After pushing, verify with:

git log --oneline origin/main..HEAD

Should show no commits (all pushed).

Troubleshooting

• Permission denied: Make sure SSH key is added to GitHub
• Key not found: Run ssh-add ~/.ssh/id_ed25519
• Connection timeout: Check your internet connection
• Wrong key: Verify key fingerprint matches GitHub

Next Steps

Once pushed, your changes will be available on GitHub and can be:

• Reviewed in pull requests
• Deployed via CI/CD
• Collaborated on with team members