Complete guide to setup Git using SSH on Windows for Bitbucket

git-ssh-setup-windows.md

🛠 Complete Guide: Set Up Git with SSH on Windows for Bitbucket

✅ 1. Generate an SSH Key (ED25519 Recommended)

Open PowerShell and run:

ssh-keygen -t ed25519 -C "your_email@example.com" -f "C:\Users\YourName\.ssh\some_service_key"

• Press Enter to accept the default location: C:\Users\YourName\.ssh\some_service_key
• Add a strong passphrase (recommended) or leave blank

---

✅ 2. Start the SSH Agent and Add Your Key

Start-Service ssh-agent
ssh-add $env:USERPROFILE\.ssh\some_service_key

You should see:

Identity added: C:\Users\YourName\.ssh\some_ssh_key

---

✅ 3. Make ssh-agent Start Automatically on Boot

Set-Service -Name ssh-agent -StartupType Automatic

---

✅ 4. Add the SSH Public Key to GitHub (Authentication + Signing)

📌 Copy Your Public Key to Clipboard

Get-Content $env:USERPROFILE\.ssh\some_ssh_key.pub | Set-Clipboard

🔐 A. Add as Authorization Key (Bitbucket)

1. Go to the Bitbucket-Server.
2. Manage account
3. "SSH-Keys"
4. Click "Add key"
5. In the "Key" text area, paste the key using Ctrl + V
6. Enter a key label.
7. Define the expiration time.
8. Click "Save"

✅ 5. Set Up Git to Use SSH Instead of HTTPS

A. When Cloning New Repositories

Use the SSH URL:

git clone git@bitbucket.arpa:project-name/your-repo.git

B. For Existing Repositories

Update the remote URL:

git remote set-url origin git@bitbucket.arpa:project-name/your-repo.git

---

✅ 6. Force Git to Use Windows OpenSSH (Fix Passphrase Prompt Issue)

Git for Windows uses its own SSH client by default.

Set Git to use the Windows OpenSSH client:

git config --global core.sshCommand "C:/Windows/System32/OpenSSH/ssh.exe"

---

✅ 7. Test Everything

A. SSH to GitHub

ssh -T git@github.com

Expected output:

Hi your-username! You've successfully authenticated...

---

✅ 8. Enable Verified Commit Signing with SSH (Git ≥ 2.34)

A. Configure Git to Sign Using SSH Key

git config --global gpg.format ssh
git config --global user.signingkey "$env:USERPROFILE\\.ssh\\id_ed25519.pub"
git config --global commit.gpgsign true

---

🎉 Done

You now have:

• ✅ SSH access to GitHub (no tokens/passwords)
• 🔐 Passphrase-free push/pull via ssh-agent
• 🧾 Verified commits with SSH signing