Configuring SSH Tunnel Manager for OSX
The instructions below are for using Tunnel Manager. Tunnel Manager is an open source free application designed
to act as a GUI front end to command line SSH. This means that all it does is run the ssh command, which you can
do for yourself. If you have difficulty getting Tunnel Manager to work, and some do, please instead drop to a
command shell and use the Unix/Linux instructions, you'll find them to be much easier.
To configure Cotse's SSH tunnel using SSH Tunnel Manager:
- Download SSH Tunnel Manager here.
- Mount the disk image and drag the program to your applications folder.
- Open the SSH Tunnel Manager Preferences window by doubleclicking the icon.
- Click the "+" button to create a new tunnel.
- Enter a name for the tunnel.
- Enter your Login (username only, no "@cotse.net").
- Enter the server you have been assigned in the Host field (The server is listed in the email you received from
- Enter the port to connect to the server on (either 22, 2222, 80, or 443).
You've now completed everything you need to get connected to the Cotse SSH Tunnel server, but you are not yet
proxied through our SSH Tunnel server. To accomplish that, you will need to set up some tunnels as described below
and in the next column.
Creating an HTTP Tunnel
In the Local redirections box in the Preferences window:
- Enter 5000 (or other local port) in the left column.
- Enter the server you have been assigned in the REMOTE Host column.
- Enter the server port to use in the right column (either 8080 for filtered, 8888 for unfiltered with header changes, 9999 for a straight through proxy that changes nothing but your IP).
- Click "Options" and make choices in the window (Auto-Connect and Handle Authentication suggested).
- Check the "Open tunnels list at run time" box at the top of the window.
- Close the Preferences window.
- In the Tunnel Manager menu bar, click "Window", then "Show Tunnels".
- Click the button to open/close the tunnel as desired. This allows HTTP forwarding from your machine, across
the SSH Tunnel to our server which is running a web proxy.
Open Safari and edit your proxy connection settings (other browsers have similar setup):
- Check the box beside "Web Proxy".
- Enter localhost for server
- Enter 5000 for (or whatever Source Port field you used in setting up Tunnel Manager, above) for the port
- Repeat above 3 steps for "Secure Web Proxy"
- Enter any URLs you don't want to proxy to in the Bypass box
- Click "Apply Now"
You're all set. Now all you have to do to use your setup is:
- Launch SSH Tunnel Manager.
- Click "Window" and "Show Tunnels".
- Click the button beside your tunnel's name to open the tunnel.
- A window should open, enter your Cotse password at the prompt and wait for the "Connected" dialog.
- Open your browser.
If you would like to check your proxy configuration to make sure that you're connected via tunnel, go to Cotse.com's proxy check and make sure that the IP shows tunnel's
IP and not your own IP.
Note that tunnel may disconnect you if you are idle for too many hours and you may need to open a new tunnel