WinSSHD

SSH Keys and ssh-agent on Windows/Linux/Mac

Using SSH to securely connect to remote servers is well understood by anyone needing to do it. However, when you ask people to use a public/private keys to connect, it starts to get a little murkier - mainly because the process is not well understood by some folks. This article breaks down the confusion and simplifies the process to a point where you'll wonder why you haven't been doing this all along.

Resolving WinSSHD Connection Problem on Mac OSX 10.7 Lion

If you've had problems connecting to servers over SSH after upgrading to Lion, you aren't alone and thankfully, there's a simple fix. Problem

From the command line, the following command will initiate an SSH connection to some server on port 60001.

$> ssh user.name@someserver -p 60001

There is nothing wrong with this command. It works, unless the SSH server you are connecting to doesn't recognize the terminal that is requested.

The error you get back isn't terribly helpful if you aren't sure how the SSH connection is formed. The terminal that you are using is sent along so that SSH knows how to interact with your SSH client. This comes the TERM environment variable.

In Snow Leopard, the requested terminal is xterm-color. In Lion, the requested terminal is xterm-color256.

You can verify this by echoing the TERM out:

$> echo $TERM

I discovered this by looking at the SSH server logs on the Windows box I was trying to connect to. I love reading server logs. So straight forward...

WinSSHD doesn't recognize xterm-color256. At least mine doesn't, and I just installed it on a couple of shiney new VMs. If you do the Google on this problem, lots of folks will tell you to just copy the terminal config files to the SSH server. Well, that's not the recommended way of doing it. In fact, the makers of WinSSHD request that you send the unsupported terminal info to them and they'll include support for it in their next release. How helpful.

Fix

Before running your connection command, set your TERM environment variable to xterm-color and you'll be just fine.

$>TERM=xterm-color

Or, whatever syntax your shell requires.