Support

Search this page:
Installation
General Usage
Account Manager
Options
Troubleshooting
Miscellaneous Questions


Installation

How do I install FireSSH?


Where do I get translated versions of FireSSH?

Go to https://addons.mozilla.org/en-US/firefox/addon/firessh/.

I've downloaded the XPI file. Can I install it manually?

One of the following should work:

How do I make a link from the desktop to FireSSH?

You can run FireSSH by typing firefox -chrome chrome://firessh/content/
In Windows you can create a new shortcut to Firefox, edit its properties by right-clicking on it and tacking on "-chrome chrome://firessh/content/" (without quotes) to the end of the "Target" field. So, for a typical Firefox installation the target field would be: "C:\Program Files\Mozilla Firefox\firefox.exe" -chrome chrome://firessh/content/

How do I uninstall FireSSH?

To uninstall go to Tools->Addons, select FireSSH and then click Uninstall.

General Usage

What is SSH?

SSH stands for Secure SHell. It is a way of accessing a remote computer in a secure fashion. Read more here.

How do I start FireSSH?

Go to your menu bar and click Tools->Web Developer->FireSSH. Alternatively, you can use the toolbar button. To add the toolbar button, right click on the Firefox toolbar and select "Customize...". Then find the FireSSH button and drag it to the toolbar somewhere.

Make sure you have successfully restarted Firefox after installation; otherwise FireSSH will not be fully installed.

How do I connect to an SSH server?

Perform the following:

How do I Copy & Paste?

To copy, do Ctrl-Shift-C (Command-Shift-C on a Mac).
To paste, do Ctrl-Shift-V (Command-Shift-V on a Mac).

Account Manager

What is Category?

Some users have many, many servers and this helps them organize the servers into categories. So, for example, you can create categories like "Work", "Home", etc. to divide and conquer your list of accounts.

What is a Private Key?

Some servers require a private key to access them. So in this field point to where the private key is stored on your computer. These files are usually stored ~/.ssh/id_dsa or ~/.ssh/id_rsa. Here are some tips on generating SSH keys. FireSSH also understands PuTTY files (usually having a .ppk extension). For l33t users: you can add the private key to the url by doing ssh://username:password@hostname:port/#pkey=
For example: ssh://blah@yomama.com/#pkey=%2FUsers%2Fmama%2F.ssh%2Fid_rsa
%2F == '/'
%5C == '\'

What are Tunnels?

Tunnels are connections you can make that bind a port on your local machine to a port on the ssh server (on the command line you would be using the -L command - this is not 'remote forwarding'). An example would be Source Port: 8080 and in the Destination field: localhost:80 This would take traffic from port 8080 on your machine and send it to port 80 on your SSH server. Read more here to get a better picture.

What is Notes?

Here you can jog down some mental notes on the particular server for your future reference.

Options

What is "Remember passwords"?

It's just what it says, really - if you uncheck this box, passwords won't be saved. You can also leave the password field blank in the account manager and FireSSH will ask you for the password when connecting (if any).

What is "Start FireFTP in a new window/tab"?

It's just what it says, really - you can have FireFTP open in a tab or a new window. The choice is yours and is a matter of, uh, preference.

What is "Show debug information"?

You can have the log show some extra information that would be useful to me, as a programmer in debugging FireSSH. If you think you've found a bug in FireSSH, be sure to check this box so that I can assess the problem more easily.

What is "Proxy"?

Most people will not have to deal with setting this but if you are using a proxy you can configure it here. FireSSH does not use the Firefox proxy settings because of the multiple ways one can connect to an SSH server through Proxy (HTTP, SOCKS, etc.) You can read more about proxies here: http://en.wikipedia.org/wiki/Proxy_server

What is "Network timeout"?

When FireSSH sends a command for a server to do something and the server doesn't respond, FireSSH will wait this many seconds before try reconnecting to the server and trying again.

What is "Keep connection alive while idle"?

When this is enabled, FireSSH will send 'noop' commands to the server to keep the connection alive (in case the server boots clients after awhile).

What is "If disconnect, try to reconnect/Retry Delay/Retry Attempts"?

If something happens to your SSH connection, FireSSH will try to get it back for you. It will wait the amount of seconds in "Retry Delay" before trying again and it will try the number of times that is in "Retry Attempts" before giving up.

Tools

What does Import/Export do?

You can use Export to export your current list of SSH sites, let's say, from your work computer and then Import them to a different computer, e.g. your home computer. Passwords are stored using encryption (although encrypted, it is best to dispose of the exported file once you're done with it). Importing is smart about not copying duplicate accounts into your current list of SSH sites. It will merge your current list with the list you are importing.

Troubleshooting

I'm having a hard time connecting!


I'm using a proxy and it's not working!

Support for proxies is limited still. Hopefully, support for proxies will improve in future versions.

I'm at my rope's end! FireSSH just doesn't seem to work for me because of a bug or another issue.

While I am continually trying to improve the program, I realize that there are limits to what my program can do. Hopefully, I'll be able to resolve your particular issue in future versions.

Miscellaneous Questions

How do I view my saved passwords?

Passwords are saved along with your other Firefox passwords. Go to Tools->Options... or (Edit->Preferences... under Linux/OS X) and from there go to Security->Show Passwords->Show Passwords. For Firefox 1.0-1.5 users it is Privacy->Passwords->View Saved Passwords->Show Passwords.

How do I make FireSSH more accessible?

To make FireSSH more accessible (enable easy keyboard shortcuts and better tabbing), you will need to setup FireSSH to open in a new window instead of a new tab. To do this go to Firefox->Tools->Add-ons->, find the FireSSH entry and select Options. Under Options, go to the Interface tab and select Start FireSSH 'in a new window'. If you find that FireSSH is lacking in accessibility, please let me know and I will try to address the issue.

Do you have older versions of FireSSH available? I need it for Firefox 1.0+

You can get those here. However, I strongly recommend you upgrade Firefox and FireSSH to their latest versions. There are many bug fixes and security fixes that come along with newer versions that help protect you during your internet experience. If you are using a public terminal, you should suggest to the owner that s/he upgrade.

How do I view and manually edit the config files?

The config files are found in your Firefox profile folder. More info on finding that folder here: http://www.mozilla.org/support/firefox/profile. fireSSHsites.dat contains your account settings (but not your passwords - those are saved in a different place along with your other Firefox passwords - see the above question for where to find that).

I would like to translate FireSSH into my language.

Sweet. Visit http://www.babelzilla.org/ for more info.

Can I have permission to include FireSSH in my magazine/software bundle/freeware CD?

Yes, go for it. Licenses, credits, and source/binary code must remained unmodified and included with package. (In FireSSH's case the 'binary' code is the source code).

How does the SSH stuff work?

It uses a javascript port of the paramiko library. I <3 javascript :)

Can I use FireSSH on a webpage?

It's not possible at this time. The web at large currently doesn't allow javascript the same amount of permissions like addons have. The main issue is basically making socket connections. No, websockets don't cut it :-/

What's the story behind FireSSH?

FireSSH is the sister project of the FireFTP project which also uses the basic underlying code.