Standard troubleshooting steps
Restart Firefox
Close Firefox completely: From the menu at the top of the Firefox windowbar, select FileFirefox and then select the ExitQuit FirefoxQuit menu item. Then restart your computer and start Firefox again.
Clear cookies and cache
Many problems with loading web pages can be resolved by clearing Firefox's cookies and cache:
- Click on the Tools menu and select Clear Recent History... to bring up the Clear Recent History window
- In the Time range to clear drop-down menu, select Everything
- Click the arrow next to Details to display the list of items to clear, then select the following items:
- Cache
- Cookies
- Click Clear Now.
For more information, see Clear Recent History. [1]
Test in Safe Mode
firefox -safe-mode
Reset preferences
( Safe mode option ) [2]
Troubleshoot extensions and themes
Sometimes add-ons for Firefox (extensions or themes) can cause problems. To confirm whether your problem is caused by an add-on, launch Firefox's Safe Mode:
- Close down Firefox completely: At the top of the Firefox window, click the File menu, and select the Quit menu item.
- Go to your Terminal and run: firefox -safe-mode
- In the Firefox Safe Mode dialog, click Continue in Safe Mode.
- Test for your problem.
If the problem does not occur in Safe Mode, an extension or theme is likely the cause. For more information about troubleshooting extensions and themes, and how to narrow down which add-on is causing problems, see Troubleshooting extensions and themes. [3]
Troubleshoot plugins
Sometimes plugins for Firefox (such as Adobe Reader, Flash, Java, RealPlayer/HelixPlayer, Rhythmbox, Totem and VLC) can cause problems.
- Open the Add-ons Window by clicking the Tools menu and selecting Add-ons
- Click on the Plugins icon at the top of the Add-ons window.
- Click each plugin in the list and then click Disable.
- Test for your problem.
For more information about various plugins, and what to do if you find the plugin that causes problems, see the Troubleshooting plugins article.
Further troubleshooting steps
If the steps above don't fix your problem, continue by following these instructions.
Make a new profile
A corrupt profile can cause various problems with Firefox. You can try to make a new profile test whether that solves the problem, and if so, copy your data (bookmarks, saved passwords, etc.) to the new profile.
Important: Before you can start the Profile Manager, Firefox must be completely closed.
- Exit Firefox. To close Firefox, at the top of the Firefox window, select the File menu, and then select Quit.
- In Terminal run: firefox -ProfileManager
- If the Profile Manager window does not open, Firefox may have been running in the background, even though it was not visible. Close all instances of Firefox or restart the computer and then try again.
- To start the Create Profile Wizard, click Create Profile... in the Profile Manager.
- Click Next and enter the name of the profile. Use a profile name that is descriptive, such as your personal name. This name is not exposed on the Internet.
- You can also choose where to store the profile, which is useful if you plan on exporting your data and settings to another computer or setup in the future. To choose its storage location on your system, click Choose Folder....
- To create the new profile, click Finish.
- Click on the newly created profile in the Profile Manager and click Start Firefox.
Test to see if your problem occurs with the new profile. If it doesn't, you can copy your data to the new profile - see Recovering important data from an old profile for instructions. For troubleshooting purposes, only copy the files that correspond to your bookmarks and saved passwords.
Slowness when browsing?
- Sometimes your loaded extensions cause your browsing to be slow. Disable them and see if performance improves.
- Many of these reference user.js [4] but you can use the about:config url as well if you prefer. Using user.js is preferable because Mozilla will not change these settings on your behalf, and you can easily undo them if something goes awry.
- Cleanly exit your browser. Go to your profile folder [5]and vacuum your db files
cd $HOME/.mozilla/firefox/*.default/; for i in *.sqlite; do echo "VACUUM;" | sqlite3 $i ; done
user_pref("browser.chrome.favicons", false); user_pref("browser.chrome.site_icons", false);
- Turn off IPv6. Append to your user.js file: [8]
user_pref("network.dns.disableIPv6", true);
- Disable dbus notifications within Firefox. Append to your user.js file: [9]
user_pref("toolkit.networkmanager.disable", true);
- Turn off rich colour support. Append to user.js: [10]
user_pref("gfx.color_management.enabled", false); user_pref("gfx.color_management.mode", 0);
- Turn off paint delay. Append to user.js: [11]
user_pref("nglayout.initialpaint.delay", 0);
Useful usability options
- Enable form colours. Append to user.js: [12]
user_pref("browser.display.use_focus_colors", true); user_pref("browser.display.focus_text_color", "#010101");
- Disable blink tag. Append to user.js: [13]
user_pref("browser.blink_allowed", false);
Additional Reading
- Additional accessibility prefs can be found here: [14]
- Additional hidden prefs can be found here: [15]
- Mozilla's own basic trouble-shooting page: [16]
- Mozilla support page: [17]