206

When using GIT, I have problems with using GIT over SSH, and since it works just fine both from work, and at home with a different modem, it's obviously my home modem that is acting up. I have no problems connecting over HTTP.

So, I'm assuming it is an SSH problem, but I'm no expert at using it directly. Is there any command I can run which sets up a "test" connection, and lets me know exactly when and where along the line the problem occurs?

Pretty much all "larger" commands (such as fetch, clone, or push with much data) from git (even when run with -v) just "hang" in the middle of connecting remotely with no indication as to why they have stopped, so they are of no use.

Is there any way I can get more details on what is happening in the SSH connection?

5 Answers 5

263

Environment variable

From Git version 2.3.0, you can use the environment variable GIT_SSH_COMMAND and pass the -v verbose argument like this:

GIT_SSH_COMMAND="ssh -v" git clone example

To be extra verbose, make it -vvv:

GIT_SSH_COMMAND="ssh -vvv" git clone example

Git config

From Git version 2.10.0, which will in Ubuntu 17.04's repos, you can save this configuration globally, or per repo as in this example:

git config core.sshCommand "ssh -vvv"
git pull
5
  • 2
    For me at least, If I do this: GIT_SSH_COMMAND="ssh -v" git clone example I can debug SSH version, it's printed after Cloning into message, but fail at git clone. After I remove GIT_SSH_COMMAND it works. In the end, served the purpose. Jan 18, 2016 at 15:06
  • 16
    For a one-time this will be better: git -c core.sshCommand="ssh -vvv" pull May 2, 2017 at 15:24
  • git config --global core.sshCommand "ssh -vvv" git clone example
    – Azodium
    Jun 5, 2018 at 10:01
  • 1
    what about older versions e.g. 1.8?
    – khaverim
    Nov 20, 2019 at 18:52
  • I will happy that there is a solution for everything in opensource ecosystem. Thanks May 20, 2020 at 6:25
98

I had a similar problem. For debugging I added a line in my ssh_config. Here is how I've done it:

git remote -v

There you will find a line like this:

origin  [email protected]:me/test.git (fetch)
origin  [email protected]:me/test.git (push)

In this case the host is github.com. Now you can add a Host-Entry in you ssh config:

vim ~/.ssh/config

And add:

Host github.com
    LogLevel DEBUG3

On using git operations, you should get plenty of debug messages, now. To get lesser debug messages, try using DEBUG1

For GIT versions >= 2.3.0 see the answer from @Flimm for a smarter solution.

16

Reading through man git, there are some useful environmental variables you can set, GIT_TRACE_PACKET and GIT_TRACE. For example:

GIT_TRACE_PACKET=true git clone ssh://[...]

A bit late to the game, but hopefully this helps someone!

1
  • 1
    This is helpful, but you do not get any messages about connection problems with SSH. But if the SSH connection works, this is the way to debug further on. Apr 14, 2015 at 9:21
5

Per man ssh:

 -v      Verbose mode.  Causes ssh to print debugging messages about its progress.  This
         is helpful in debugging connection, authentication, and configuration problems.
         Multiple -v options increase the verbosity.  The maximum is 3.

So, try ssh -v. If that doesn't tell you what you need to know, you can add one or two vs for even more detailed debugging information. For Github in particular, try ssh -vvvT [email protected].

Usually, in my experience, an SSH session hanging during setup happens when the client can't complete the chosen authentication method. Check that your private key is in the right place with the right permissions and matches the public key you've given Github.

3
  • Thanks for the answer, but I should probably have asked the question differently (since GitHub doesn't allow direct SSH connections like that). I edited the post and title, but is it better to discard this one and create a new question instead?
    – IQAndreas
    Sep 12, 2013 at 21:52
  • @IQAndreas, GitHub does allow SSH connections like that in the sense that the authentication phase will be carried out and if the problem is indeed happening in the SSH step, you'll see it that way. If you're finding that you can't even get that far, something is going on that's preventing the connection from even being made.
    – tgies
    Sep 13, 2013 at 10:01
  • 1
    I'm being authenticated just fine, and sometimes push/pull on the repo with no problems. But often it just "hangs" in the middle of the command and won't continue (especially when I transfer large amounts of data such as a large clone or push). There are no error messages, it just sits there and doesn't continue.
    – IQAndreas
    Sep 13, 2013 at 20:40
3

I don't see a way to tell git(1) the external command to use for ssh(1), but as a workaround, simply rename /path/to/ssh to /path/to/ssh.orig, create a shell script wrapper /path/to/ssh, and add in the -v flags:

$ sudo mv /usr/bin/ssh /usr/bin/ssh.orig
$ sudo vim /usr/bin/ssh
$ cat /usr/bin/ssh
#!/bin/sh

if [ -x /usr/bin/ssh.orig ]; then
    exec /usr/bin/ssh.orig -v -v -v "${@}"
fi

$ sudo chmod a+x /usr/bin/ssh

I get verbose output when executing git commands operating over an ssh transport. Once done debugging, delete the script and restore /path/to/ssh.orig to /path/to/ssh.

3
  • 4
    Instead of moving files in /usr/bin, consider putting the wrapper script in /usr/local/bin.
    – muru
    Oct 23, 2014 at 17:28
  • 2
    At least on my strange Windows install, the environment variable GIT_SSH can be set to point to the binary you want Git to use.
    – Coderer
    Jan 22, 2015 at 10:29
  • As said, you definitely don't want to modify the original ssh file, but I would have reservations about the workaround in /usr/local/. It's not transparent, and it is easily stomped on. BETTER: put your workaround script into $HOME/bin and add that new bin dir in your user's $PATH variable, ahead of other PATH segments. And before doing that, I'd check if there isn't an ENV var solution that's even better (this answer is old). Nov 7, 2018 at 17:47

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .