Created: 2008-12-20 09:23
Updated: 2016-05-08 20:05



A simple binary to provide three functionalities relating to SSH tunnels:

  • Starting a new tunnel, that opens at a port on a server you have SSH access to, and dumps at a port on your desktop computer
  • Creating a launchd script for Mac OS X machines that provides the same functionality on demand
  • Easily and quickly configuring a completely un-configured computer for keypair-based SSH access to a server


tunnelr start [options] remote.server.tld:12345 localhost:3000
tunnelr launchd [options] remote.server.tld:12345 localhost:3000
tunnelr setup [options] remote.server.tld

Send --help to any of the above commands for a list of allowed flags.


Only the first functionality is currently provided.


You must have autossh for the first and second tools. This can be installed on Mac OS X (if you have MacPorts) as follows:

port install autossh

Instructions for installing MacPorts are available at http://trac.macports.org/wiki/InstallingMacPorts.

You obviously need SSH access to a server to use any of these, though you don’t need it to be configured specially — the third task listed above will take care of any and all of that for you.

Finally, you obviously need to be on a Mac, running OS X 10.5 Leopard (or a more recent version of OS X that provides [launchd][]), to use the second command.

Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more