From Fedora Project Wiki

Revision as of 09:39, 27 August 2020 by Stransky (talk | contribs)

Standard troubleshooting steps

Restart Firefox

Close Firefox completely: From the menu at the top of the Firefox windowbar, select File and then select the Quit menu item. Then restart your computer and start Firefox again.

Create a new profile

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.

  1. Exit Firefox. To close Firefox, at the top of the Firefox window, select the File menu, and then select Quit.
  2. In Terminal run: firefox -ProfileManager -no-remote
    • 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.
  3. To start the Create Profile Wizard, click Create Profile... in the Profile Manager.
  4. 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.
  5. To create the new profile, click Finish.
  6. 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.

Clear cookies and cache

Many problems with loading web pages can be resolved by clearing Firefox's cookies and cache. If the new profile helps you, you can try to clear your existing old profile:

  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.
  5. Exit your browser
  6. Clear Flash cookies
    • find ~/.macromedia/ -type f -name \*.sol -exec rm '{}' \;

For more information, see Clear Recent History. [1]

Troubleshoot Add-ons / plugins

Sometimes add-ons for Firefox (Extensions, Themes or Plugins) can cause problems and you can disable them one-by-one:

  1. Open the Add-ons Window by clicking the Tools menu and select Add-ons.
  2. There are three tabs - Extensions, Themes, Plugins so select the one you want to test
  3. Disable each extensions/theme/plugin in the list.
  4. Test for your problem.

Check WebRedner

WebRender is a new Firefox hardware accelerated back end. It's not enabled by default you but you can test it and check if it solves your issues. Also when you have WebRender already enabled, turn it off and try again.

  1. Go to about:support page and check Compositing field. It's Basic for software rendering and WebRender otherwise.
  2. Go to about:config page and look for gfx.webrender.all and gfx.webrender.enabled preferences. Turn them on/off according your preference.
  3. Restart browser, check at about:support WebRender status.

Check Firefox X11 Gtk+ backend (Gnome only)

Firefox can run with two independent Gtk+ backends / graphics servers where Wayland is a default one on Gnome Shell. If you run Gnome, please try to reproduced your issue on Firefox X11 backend.

  1. install firefox-x11 package
  2. close all active firefox instances
  3. run Firefox on X11 from menu or firefox-x11 in Terminal

Collect information for a bug report

Please provide those information to your bug report. [2]

Exact Firefox version, type this command in terminal: 

rpm -q firefox

Firefox troubleshooting data, in the URL bar, visit this link: 

about:support

and use Copy text to clipboard to copy/paste it.

Testing Mozilla binaries

Some issues can be Fedora specific, caused by build environment, patches and so on. It's important to try vanilla binaries from Mozilla project to negate that case.

  1. Download Firefox [3]/Thunderbird[4] from Mozilla site directly .
  2. Unpack the tarball.
  3. In Terminal run locally as ./firefox -ProfileManager -no-remote (./thunderbird -ProfileManager -no-remote), create a new profile and test your issue. It runs with X11 backend by default.
  4. To use Wayland native backend run as MOZ_ENABLE_WAYLAND=1 ./firefox -ProfileManager -no-remote. Mozilla thunderbird does not support Wayland yet.

Some issues can be already fixed in Beta or Nightly which are pre-release and development versions. Please also check those two if you can reproduce it issue.

  1. Download Firefox Beta/Nightly [5] or Thunderbird Beta [6] from Mozilla site.

Use Mozregression tool

Mozregression tool [7] can be used to find offending changeset. Install mozregression on terminal by

pip install mozregression

and run

mozregression --good version_good --bad version_bad

where version_good and version_bad are affected Firefox version. For instance when something bad happens between Firefox 78 and 79, you can find that by:

mozregression --good 78.0 --bad 79.0

The mozregression wool will launch various Firefox versions and as you if the launched version is good or bad. When the bi-section is finished a regression range is printed.

Additional Reading

  • Additional accessibility prefs can be found here: [8]
  • Additional hidden prefs can be found here: [9]
  • Mozilla's own basic trouble-shooting page: [10]
  • Mozilla support page: [11]
Retrieved from "https://fedoraproject.org/w/index.php?title=How_to_debug_Firefox_problems&oldid=586487"