// learn ssh

SSH guides for Mac developers

Practical SSH guides for macOS: generate keys, use multiple GitHub accounts, fix Permission denied (publickey) and master ~/.ssh/config.

Step-by-step answers to the SSH problems developers actually hit on macOS, written by the team behind EasySSHConfig and checked against Apple's OpenSSH.

troubleshooting

How to fix “Permission denied (publickey)” on a Mac

Seven real causes of SSH's Permission denied (publickey) error on macOS, how to spot each one with ssh -v, and the exact fix for GitHub and servers.

Read guide →
git & github

How to use multiple GitHub accounts with SSH on one Mac

Use a personal and a work GitHub account on one Mac with SSH: separate keys, a host alias in ~/.ssh/config, per-folder Git settings and the fixes that matter.

Read guide →
troubleshooting

Fix SSH “Received disconnect: Too many authentication failures”

Why SSH says Too many authentication failures when you have several keys, and three fixes: IdentitiesOnly, one key per host, and a leaner ssh-agent.

Read guide →
ssh keys

How to generate an SSH key on a Mac (Ed25519)

Create an Ed25519 SSH key on macOS with ssh-keygen, protect it with a passphrase saved in Keychain, add it to GitHub or a server, and test the connection.

Read guide →
ssh config

The ~/.ssh/config file, explained (with examples)

How ~/.ssh/config works on Mac and Linux: Host blocks, the options you'll actually use, why the first value wins, Include, and how to test your config.

Read guide →
ssh config

SSH config wildcards and Host patterns: which rule wins?

How SSH matches Host patterns with *, ? and ! in ~/.ssh/config, why ordering alone can't make the specific host win, and the negation pattern that does.

Read guide →
ssh config

IdentitiesOnly yes: stop SSH from trying every key

What IdentitiesOnly does in ~/.ssh/config, why ssh-agent offers keys you never asked for, and when to use IdentitiesOnly yes, including with 1Password.

Read guide →
macos

Save your SSH key passphrase in the macOS Keychain

Stop typing your SSH passphrase on a Mac: ssh-add --apple-use-keychain, UseKeychain and AddKeysToAgent in ~/.ssh/config, plus a config that also works on Linux.

Read guide →