Skip to content
GitTree
Preferences

Configure SSH in GitTree

Preferences › SSH lists the keys in your .ssh folder, creates new ones, shows each host from your SSH configuration and tests a connection. GitTree never starts an SSH agent and never edits ~/.ssh/config or core.sshCommand; a key you choose for SSH remotes is passed to git commands it runs.

FreeUpdated

Works in GitTree Free: every local Git feature, once you are signed in.

On this page
  1. Before you start
  2. Where to find it
  3. Steps
  4. Expected result
  5. SSH settings
  6. If something goes wrong
  7. Questions
  8. Related

Before you start

  • OpenSSH is installed (it ships with macOS, Windows 10 and later, and most Linux distributions).

Where to find it

  • Preferences › SSH: Keys, Generate a new key, Hosts and Test a connection.
ActionmacOSWindows and Linux
Preferences⌘,Ctrl+,

Steps

  1. Generate a key

    Under Generate a new key, keep Ed25519 (recommended), set a File name and Comment, tick Protect the key with a passphrase (your system asks for it in its own dialog) and press Generate Key. An existing key is never overwritten.

  2. Add it to your host

    Press Copy Public Key and add it on your host’s SSH keys page, or Upload to Account… for a connected account that allows it.

  3. Test it

    Under Test a connection, enter the Host (such as github.com) and User (git), and press Test. The host accepted your key. means it works.

Expected result

Git over SSH works with your key, and you know which host uses which key.

SSH settings

  • Use the SSH agent: offer the keys your running agent holds.
  • Private key: one key for every SSH remote, used alone; empty lets ssh choose.
  • Unknown host keys: Ask me (shows the fingerprint first), Accept new hosts, refuse changed ones or Refuse hosts I have not trusted.
  • Remember key passphrases keeps them in your system keychain only.

If something goes wrong

“The private key is not in this folder.”

Only the .pub file is there. Copy the private key into the same folder, or generate a new pair.

Questions

Can I turn off host key checking?

No. The strictest choice refuses unknown hosts, and Ask me shows the fingerprint so you can compare it with the one its owner published.