From Fedora Project Wiki
No edit summary
No edit summary
Line 9: Line 9:
Many problems with loading web pages can be resolved by clearing Firefox's cookies and cache:
Many problems with loading web pages can be resolved by clearing Firefox's cookies and cache:


  1. Click on the Tools menu and select Clear Recent History... to bring up the Clear Recent History window
1. Click on the Tools menu and select Clear Recent History... to bring up the Clear Recent History window
  2. In the Time range to clear drop-down menu, select Everything
2. In the Time range to clear drop-down menu, select Everything
  3. Click the arrow next to Details to display the list of items to clear, then select the following items:
3. Click the arrow next to Details to display the list of items to clear, then select the following items:
           * Cache
           * Cache
           * Cookies  
           * Cookies  
  4. Click Clear Now.  
4. Click Clear Now.  


For more information, see Clear Recent History. [http://support.mozilla.com/en-US/kb/Clear+Recent+History]
For more information, see Clear Recent History. [http://support.mozilla.com/en-US/kb/Clear+Recent+History]
Line 20: Line 20:
'''Test in Safe Mode'''
'''Test in Safe Mode'''


    ''firefox -safe-mode''
''firefox -safe-mode''


'''Reset preferences'''
'''Reset preferences'''
Line 30: Line 30:
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:
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:


  1. Close down Firefox completely: At the top of the Firefox window, click the File menu, and select the Quit menu item.
1. Close down Firefox completely: At the top of the Firefox window, click the File menu, and select the Quit menu item.
  2. Go to your Terminal and run:
2. Go to your Terminal and run:
       firefox -safe-mode
       firefox -safe-mode
  3. In the Firefox Safe Mode dialog, click ''Continue in Safe Mode''.
3. In the Firefox Safe Mode dialog, click ''Continue in Safe Mode''.
  4. Test for your problem.  
4. 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. [http://support.mozilla.com/en-US/kb/Troubleshooting+extensions+and+themes]
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. [http://support.mozilla.com/en-US/kb/Troubleshooting+extensions+and+themes]
Line 42: Line 42:
Sometimes plugins for Firefox (such as Adobe Reader, Flash, Java, QuickTime, RealPlayer, and VLC) can cause problems.
Sometimes plugins for Firefox (such as Adobe Reader, Flash, Java, QuickTime, RealPlayer, and VLC) can cause problems.


  1. Open the Add-ons Window by clicking the Tools menu and selecting Add-ons
1. Open the Add-ons Window by clicking the Tools menu and selecting Add-ons
  2. Click on the Plugins icon at the top of the Add-ons window.
2. Click on the Plugins icon at the top of the Add-ons window.
  3. Click each plugin in the list and then click Disable.
3. Click each plugin in the list and then click Disable.
  4. Test for your problem.  
4. 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.  
For more information about various plugins, and what to do if you find the plugin that causes problems, see the Troubleshooting plugins article.  
Line 55: Line 55:


'''Make a new profile'''
'''Make a new profile'''
    ''firefox -ProfileManager''
 
''firefox -ProfileManager''


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.
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.


  1. Start the Profile Manager - see Starting the Profile Manager for instructions.
1. Start the Profile Manager - see Starting the Profile Manager for instructions.
  2. Create a new profile - see Creating a profile for instructions.
2. Create a new profile - see Creating a profile for instructions.
  3. Click on the newly created profile in the Profile Manager and click Start Firefox.  
3. 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.  
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? ==
== 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 [http://kb.mozillazine.org/User.js_file] 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.
Many of these reference user.js [http://kb.mozillazine.org/User.js_file] 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 [http://kb.mozillazine.org/Profile_folder]and vacuum your db files
Cleanly exit your browser. Go to your profile folder [http://kb.mozillazine.org/Profile_folder]and vacuum your db files
    ''cd $HOME/.mozilla/firefox/*.default/; for i in *.sqlite; do echo "VACUUM;" | sqlite3 $i ; done''
 
''cd $HOME/.mozilla/firefox/*.default/; for i in *.sqlite; do echo "VACUUM;" | sqlite3 $i ; done''


Disable favicon and site-icon caching.  Append do your user.js file: [http://kb.mozillazine.org/Browser.chrome.favicons] [http://kb.mozillazine.org/Browser.chrome.site_icons]
Disable favicon and site-icon caching.  Append do your user.js file: [http://kb.mozillazine.org/Browser.chrome.favicons] [http://kb.mozillazine.org/Browser.chrome.site_icons]
    ''user_pref("browser.chrome.favicons", false);''
 
    ''user_pref("browser.chrome.site_icons", false);''
''user_pref("browser.chrome.favicons", false);''
''user_pref("browser.chrome.site_icons", false);''


Turn off IPv6.  Append to your user.js file: [http://kb.mozillazine.org/Network.dns.disableIPv6]
Turn off IPv6.  Append to your user.js file: [http://kb.mozillazine.org/Network.dns.disableIPv6]
Line 80: Line 86:


Disable dbus notifications within Firefox.  Append to your user.js file: [http://kb.mozillazine.org/Toolkit.networkmanager.disable]
Disable dbus notifications within Firefox.  Append to your user.js file: [http://kb.mozillazine.org/Toolkit.networkmanager.disable]
    ''user_pref("toolkit.networkmanager.disable", true);''
 
''user_pref("toolkit.networkmanager.disable", true);''


Turn off rich colour support.  Append to user.js:  [http://kb.mozillazine.org/Gfx.color_management.enabled]
Turn off rich colour support.  Append to user.js:  [http://kb.mozillazine.org/Gfx.color_management.enabled]
    ''user_pref("gfx.color_management.enabled", false);''
 
    ''user_pref("gfx.color_management.mode", 0);''
''user_pref("gfx.color_management.enabled", false);''
''user_pref("gfx.color_management.mode", 0);''


Turn off paint delay. Append to user.js: [http://kb.mozillazine.org/Nglayout.initialpaint.delay]
Turn off paint delay. Append to user.js: [http://kb.mozillazine.org/Nglayout.initialpaint.delay]
    ''user_pref("nglayout.initialpaint.delay", 0);''
 
''user_pref("nglayout.initialpaint.delay", 0);''




'''Useful usability options:'''
'''Useful usability options:'''
Enable form colours.  Append to user.js: [http://kb.mozillazine.org/Browser.display.focus_background_color]
Enable form colours.  Append to user.js: [http://kb.mozillazine.org/Browser.display.focus_background_color]
    ''user_pref("browser.display.use_focus_colors", true);''
 
    ''user_pref("browser.display.focus_text_color", "#010101");''
''user_pref("browser.display.use_focus_colors", true);''
''user_pref("browser.display.focus_text_color", "#010101");''


Disable blink tag.  Append to user.js: [http://kb.mozillazine.org/Browser.blink_allowed]
Disable blink tag.  Append to user.js: [http://kb.mozillazine.org/Browser.blink_allowed]
    ''user_pref("browser.blink_allowed", false);''
''user_pref("browser.blink_allowed", false);''


== Additional Reading ==


Additional accessibility prefs can be found here: [http://kb.mozillazine.org/Accessibility_features_of_Firefox]
Additional accessibility prefs can be found here: [http://kb.mozillazine.org/Accessibility_features_of_Firefox]


Additional hidden prefs can be found here: [https://www.mozilla.org/unix/customizing.html]
Additional hidden prefs can be found here: [https://www.mozilla.org/unix/customizing.html]

Revision as of 04:05, 15 August 2010

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:

1. Click on the Tools menu and select Clear Recent History... to bring up the Clear Recent History window
2. In the Time range to clear drop-down menu, select Everything
3. Click the arrow next to Details to display the list of items to clear, then select the following items:
         * Cache
         * Cookies 
4. 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:

1. Close down Firefox completely: At the top of the Firefox window, click the File menu, and select the Quit menu item.
2. Go to your Terminal and run:
     firefox -safe-mode
3. In the Firefox Safe Mode dialog, click Continue in Safe Mode.
4. 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, QuickTime, RealPlayer, and VLC) can cause problems.

1. Open the Add-ons Window by clicking the Tools menu and selecting Add-ons
2. Click on the Plugins icon at the top of the Add-ons window.
3. Click each plugin in the list and then click Disable.
4. 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

firefox -ProfileManager

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.

1. Start the Profile Manager - see Starting the Profile Manager for instructions.
2. Create a new profile - see Creating a profile for instructions.
3. 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

Disable favicon and site-icon caching. Append do your user.js file: [6] [7]

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]