First, install the tunnlr plugin with this command:

    script/plugin install git://github.com/mmangino/tunnlr_connector.git
  

For the plugin to work, you will need to install the latest version of the net-ssh gem:

    gem install net-ssh
  

You should also install the highline gem:

    gem install highline
  

Next, configure Tunnlr. You'll need to add the following information to config/tunnlr.yml. You'll need to replace PASSWD with your tunnlr password.

    username: tunnlr0
    host: ssh1.tunnlr.com
    password: PASSWD
    remote_port: 5000
    local_port: 3000
	

Then, any time you need a tunnel:

     rake tunnlr:start
  

Are you using Facebooker to build your Facebook application? If so, your facebooker.yml file should look like:

    development:
      api_key: <your_api_key>
      secret_key: <your_secret_key>
      canvas_page_name: <your_app_name>
      callback_url: http://web1.tunnlr.com:5000
      
      tunnel:
        public_host_username: tunnlr0
        public_host: ssh1.tunnlr.com
        public_port: 5000
        local_port: 3000
  

After editing your facebooker.yml file, create a tunnel with

    rake facebooker:tunnel:background_start
  

On Windows, you'll need to use PuTTY. To get started, you should download PuTTY. I recommend the installer package.

After installing Putty, start the "PuTTYgen" executable and click "Generate" to create your keys.

After generating a key, copy the text from the public key area.

Next, you should log in to your Tunnlr account and paste your public key into the box. Click save. It may take a minute or two for your key to be updated on our servers.

After uploading your key, click "save private key" and save your key to a location you will remember. We'll need it in a minute.

Next, start a new PuTTY session. Enter your tunnlr hostname (ssh1.tunnlr.com) into the Host Name box. The Port should be set to 22.

Click on the "SSH" area under "Connection" and place a checkbox next to "Don't start a shell or command at all"

Then, expand the "SSH" area and select tunnels. You should check both boxes at the top. Enter your port number (5000) into the source port box. Enter your destination host and port in the destination box. For connecting to a local webserver such as Apache or IIS, enter 127.0.0.1:80. For Rails enter 127.0.0.1:3000. Finally, check "Remote"

Click "Add" to complete the tunnel setup.

Next, click "Data" under "connections" and enter your Tunnlr SSH username (tunnlr0).

Under "SSH", click "Auth" and then click "Browse" to open the private key that you saved earlier.

Finally, go back to the session screen and enter a name in the "Saved Sessions" box. Then click "Save"

You can now click "Open" to create your tunnel. The next time you want a tunnel, you can simple click on the name of your tunnel under "Saved Sessions" and click "Load" followed by "Open"

To create a tunnel to port 8080, run the following command:

    ssh  -nNt -g -R :5000:0.0.0.0:8080 tunnlr0@ssh1.tunnlr.com
  

We never store your credit card number on our servers. Our payment processor keeps it in their secure customer vault.

Tunnlr costs $5.00 per month. That's much less than a static IP address or a hosting account.

Tunnlr only allows you to send inbound HTTP traffic to your machine. It is not a tool to bypass your employer's web filters. Nice try, though!