Git and SSH keys


How to tell Git which ssh key to use when connecting to Git repositories?


I have upload and verify my id_dsa key to GitHub, but still can’t use GitHub because it insists that my id_rsa key is not registered.

Similar situations would be,

  • I have several private key files (server1, server2). And both servers have git repos. The problem is that I can not use the same private key for both servers and have to tell Git which one to use.
  • Or, you need to authenticate Git/GitHub repositories with per-repository keys.

Solution Synopsis

Use the ~/.ssh/config file to tell Git which key to use.

I.e., to tell GitHub to use my id_dsa key instead of the default id_rsa:

$ tail -2 ~/.ssh/config
    IdentityFile ~/.ssh/id_dsa



  1. Modify ~/.ssh/config as above
  2. Test ssh into Git
  3. Test Git repo access (with the configured key)


$ tail -2 ~/.ssh/config
    IdentityFile ~/.ssh/id_dsa
$ ssh
PTY allocation request failed on channel 0
Hi suntong001! You've successfully authenticated, but GitHub does not provide shell access.
Connection to closed.
$ git remote show github
* remote github
  Fetch URL:
  Push  URL:
  HEAD branch: master
  Remote branches:
    master                     tracked
    refs/remotes/origin/master tracked
  Local refs will be mirrored by 'git push'


Using Multiple SSH Public Keys

The problem now is that it appears that my default key is used everywhere and I can’t find out how to specify a key to use in Git for individual repos.

So my question is: How do I specify an SSH key to use on a repo-to-repo basis?

If you have an active ssh-agent that has your id_rsa key loaded, then the problem is likely that ssh is offering that key first. Unfuddle probably accepts it for authentication (e.g. in sshd) but rejects it for authorization to access the company repositories (e.g. in whatever internal software they use for authorization, possibly something akin to Gitolite).

The IdentitiesOnly .ssh/config configuration keyword can be used to limit the keys that ssh offers to the remote sshd to just those specified via IdentityFile keywords (i.e. it will refuse to use any additional keys that happen to be loaded into an active ssh-agent).

Try these .ssh/config sections:

Host {personalaccount}
     IdentityFile ~/.ssh/id_rsa
     IdentitiesOnly yes
Host {companyaccount}
     IdentityFile ~/.ssh/{companyaccount}_rsa
     IdentitiesOnly yes

Then, use Git URLs like these:


If you want to take full advantage of the .ssh/config mechanism, you can supply your own custom hostname and change the default user name:

Host uf-mine
     HostName {personalaccount}
     User git
     IdentityFile ~/.ssh/id_rsa
     IdentitiesOnly yes
Host uf-comp
     HostName {companyaccount}
     User git
     IdentityFile ~/.ssh/{companyaccount}_rsa
     IdentitiesOnly yes

Then, use Git URLs like these:

— answered Apr 19 ’11 by Chris Johnsen

NB, the last example can also cover the case that you need to authenticate Git/GitHub repositories with per-repository keys.


git-push with specific SSH key

11 August 2011

I wanted to use a specific key for this server.

Connecting via SSH to the server with the key is as simple as adding -i /path/to/key. The problem arose when I needed to be able to push to a Git repository hosted on the server, and adding -i to git-push doesn’t work.

The solution was to add a Host directive to my ~/.ssh/config file. Then, use that Host to connect to when push’ing to the remote server.

If it doesn’t exist, create the file ~/.ssh/config. Add the following to it, editing where necessary.

Host RemoteServer
 HostName remote-server.tld
 User git
 IdentityFile ~/.ssh/remoteserver_key

This example config would be the equivalent of running a command like ssh git@remote-server.tld -i ~/.ssh/remoteserver_key. You can even run ssh RemoteServer to test the connection out.

In your Git repository, add a new remote repository. Here I’ve called it origin, as the convention might have it.

git remote add origin RemoteServer:path/to/repository.git

Instead of specifying a user @ a domain, it uses the name of the Host in the SSH config. The path/to/repository.git is relative, on the average system, that will probably point to /home/git/path/to/repository.git.

Try running a git push origin master to see if it works!

This entry was posted in Uncategorized and tagged by sfxpt. Bookmark the permalink.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s