Warning This information may be out of date since FireWatir 1.2.1. Please see FireWatir Installation

Installation guide for FireWatir:

1. Install Firefox 1.5 or higher version (http://www.mozilla.com/firefox/). It may or may not run with earlier version of Firefox.
2. Install JSSh XPI using following steps:
   1. Open Firefox browser.
   2. From File menu select Open File option.
   3. Navigate to the path where "JSSh XPI" folder is located. Select 'XPI' inside this folder and click open.
   4. Wait till a dialog appear stating that do you want to install this extension. Click install.
   5. Close Firefox. Restart it from command prompt using "<Firefox installation directory>/firefox.exe -jssh". Make sure you give "-jssh" as parameter other wise Firefox will not start JSSh shell.
   6. To check if JSSh is listening on port 9997 run command "telnet localhost 9997" from command prompt.
3. Install Firewatir using the following command
   gem install firewatir
4. Go to gem install directory in ruby installation. Go to Firewatir gem directory and then to unit tests directory. Run "mozilla_all_tests.rb" to run the unit test cases. Make sure you have started Firefox manually as stated in step 2.5 if you are using Mac machine. On windows and Linux just run "mozilla_all_tests.rb".
5. If "attach_new_browser" test fails then,
   1. Make sure that pop ups are allowed in Firefox. To allow the pop up run this test alone and then allow the pop ups.
   2. Make sure that Firefox settings should be open new window instead of new tab when link is clicked.