Clean Install a Viewer.


Full Clean Install of Firestorm

If you are attempting to update from a blocked version of Firestorm, refer to this page.

The following explains how to do a proper clean install - which is more than simply removing the viewer and reinstalling it. You may need to follow this procedure if you have problems.

Before You Begin

Step 1: Get the Installer

For the current release, go to the Downloads page.
For any previous supported version, go to the Older Downloads page.

Step 2: Back Up Chat Transcripts (Recommended)

If you save chat transcripts, they are by default saved in your per-account settings folder (named for your avatar). Before you delete that folder (below), you will need to identify the chat files and move them. See here for steps to relocate your chat transcripts. This only needs to be done once if you then backup your settings. But you must log in on each account (i.e., alts) to save that account's chat files.

Step 3: Back Up Settings (Recommended)

As a just-in-case measure for any situation, and to make upgrading or downgrading your viewer much easier, make a backup of your settings. It's a good idea to make a backup right before upgrading, downgrading or otherwise wiping settings so that the backup is current (teleport history, contact sets, etc. can change dynamically). You must log in on each account (i.e., alts) in order to back up that account's settings.

Remove Your Current Install

Step 4: Delete Settings

REMINDER: If you want to save chat transcripts and or settings, make sure you do Steps 1 and 2 before deleting your settings.

Firestorm settings can become corrupt, particularly if you recently crashed; the files may not save completely, so important information can become “scrambled”. And when installing a different version of the viewer, using settings from the previously installed version may cause undesirable behavior in the viewer.

Here is how to remove the old settings:

Method 1: If you are able to launch Firestorm

  • Launch the viewer but do not log in.
  • Click the Viewer menu at the top, choose Preferences, then Network & Files, then Directories.
  • Click the Open Settings Folder button.
  • Close the viewer.
  • In the file window, navigate up one folder, to the Firestorm* folder. If you see a folder called user_settings and one or more named for your avatars, you're in the right place.
  • Select everything in that Firestorm folder and delete it.

*Note that the Firestorm folder name may differ slightly.

Note also that if you have both a 32-bit and 64-bit version installed, you will only be deleting settings for the version that you launched at the beginning of this step. You would have to repeat this step if you want to delete settings for the other version that's still installed.

Method 2: If you are *unable* to launch Firestorm

You will need to use a file manager (like Windows Explorer for Windows system, Dolphin, the Mac Finder, or some such) to locate the settings folder. In its default location, the folder is hidden on most OSs. To find it, you will need to show hidden folders. Refer to this page to locate your settings folders.

Step 5: Clear Cache

Clearing cache should only be done when there is a problem with the cache, or when there is a significant change in the viewer that requires it (such as a change to the KDU render code). The viewer will automatically clear cache in such cases, but manual clearing may be quicker.

When downgrading, you should always clear the cache.

If you have to clear cache in order to use the viewer version you are about to install, please see this page.

Step 6: Remove Application

For Windows

Ideally, use the Programs & Features Control Panel [Win7, Win8.1, Win10], or Add/Remove Programs Control Panel to remove the Firestorm application. If you have a Firestorm folder in your Start Menu, there may be an Uninstall link there (32-bit Firestorm only).

Install the New Version

Step 7: Install Firestorm

Having done all those steps, you may now install Firestorm. Installing Firestorm is done in pretty much the same way as any other application on your computer.

For Windows

Run the downloaded installer.
The 32-bit installer will offer you the chance to change the destination directory.
The 64-bit installer shows the destination when you click the Options button.
The installer will create a shortcut icon on the desktop.

Note: Both installers offer you an option to start the viewer when it's done, and you should choose No.
Choosing Yes tends to cause problems for some people, especially if they restore during that session.
The shortcut is the preferred way to launch the viewer.

Flash Player

Go to Adobe Flash Player, select your operating system, then select the appropriate flash player.

Step 8: Log in

Once you have the viewer installed or reinstalled, you will want to make sure the viewer is operating correctly:

  • Log back into SL, to a quiet region (try Hippo Hollow, Aich or Hatton). Don't change any settings.
  • Test any functions that didn't work for you in the previous version that had been reported fixed.
  • If downgrading, test any functions that failed in the newer version.
  • If you needed to clear cache in Step 5 above, open your Inventory and wait for it to fully populate.

Step 9: Restore Settings

At this point, if the viewer is performing as it should, you can restore your settings and again relog. You must log in on each account (i.e., alts) to restore that account's settings.

Log back in to SL once again and confirm that the viewer is still performing as it should; then you can adjust any new or changed settings and then back those up.

Note that some settings are not restored, such as graphics. This is because the graphics settings could be incorrect and may cause problems.