From Fedora Project Wiki

(34 intermediate revisions by the same user not shown)
Line 3: Line 3:
== Restart Firefox ==
== 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.  
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 ==
== Verify Firefox installation integrity ==
 
Open terminal and run this command:
 
'''rpm -qV firefox'''
 
If Firefox installation is correct you don't get any output. If there's something printed please re-install Firefox by rpm/dnf on terminal as:
 
'''sudo dnf remove firefox'''<br>
'''sudo dnf install firefox'''
 
== Run in safe mode ==
 
Safe mode can be used to start Firefox in basic safe configuration. Open terminal and:
 
* Make sure no Firefox instance is running. This terminal command:
 
'''pidof firefox'''
 
should not print any output as it reports PID of running Firefox instances. If you see any running instances please reboot your computer (or use kill/killall command).
 
* Launch Firefox in safe mode
 
'''firefox --safe-mode'''
 
== Test Firefox with a new profile ==


If the steps above don't fix your problem, continue by following these instructions.  
If the steps above don't fix your problem, continue by following these instructions.  
Line 16: Line 41:


# Exit Firefox. To close Firefox, at the top of the Firefox window, select the File menu, and then select Quit.
# 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 -no-remote'''
# 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.
#* 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.
# To start the Create Profile Wizard, click ''Create Profile...'' in the Profile Manager.
Line 23: Line 48:
# Click on the newly created profile in the Profile Manager and click Start Firefox.  
# 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 [https://support.mozilla.org/en-US/kb/recovering-important-data-from-an-old-profile Recovering important data from an old profile] for instructions.
 
'''If Firefox fails to start''' with your recent profile and says '''Firefox is already running''' you can try to delete lock from your default profile to recover it:
 
# Find a default profile directory (it's usually ~/.mozilla/firefox/xxxxxx.default), you can get it at ~/.mozilla/firefox/profiles.ini file.
# Remove 'lock' file for it (when Firefox crashes the profile may be locked).
# Try to start Firefox again on terminal, check for any error messages.


== Clear cookies and cache ==
== Clear cookies and cache ==
Line 50: Line 81:
# Test for your problem.  
# Test for your problem.  


== Check WebRender ==
== Firefox performance issues ==
 
There are two sources of possible performance issues - opened site/addon or Firefox itself. To identify hungry site/addon go to
 
'''about:performance'''
 
page and check for component which uses most of resources.
 
Firefox internal performance issues can be investigated by Firefox Profiler, go to:
 
'''https://profiler.firefox.com/'''
 
site and enable Firefox profiling. Please share and attach the profile to bugreport (you can also anonymize it).
 
== Check WebRender state (Hardware acceleration) ==


WebRender is Firefox hardware accelerated back end which uses OpenGL. It's enabled by default on Gnome/X.org and Gnome/Wayland for Intel/AMD graphics cards. You can try to switch it on/off to check if that solves your issues.  
WebRender is Firefox hardware accelerated back end which uses OpenGL. It's enabled by default on Gnome/X.org and Gnome/Wayland for Intel/AMD graphics cards. You can try to switch WebRender to software backend to check if that solves your issues.


[[File:Webrender-about.png|thumb|center|WebRedner Firefox setup]]
[[File:Webrender-about.png|thumb|center|WebRedner Firefox setup]]


# Go to '''about:support''' page and check '''Compositing''' field. It's '''Basic''' for software rendering and '''WebRender''' otherwise.
# Go to '''about:support''' page and check '''Compositing''' field. It's '''WebRender''' for hardware/OpenGL rendering and '''WebRender (Software)''' for software one.
# To '''enable''' WebRender, go to '''about:config''' page and look for '''gfx.webrender.all''' and '''gfx.webrender.enabled''' preferences and set them to '''true'''.
# To '''disable''' WebRender hardware backend, go to '''about:config''' page and look for '''gfx.webrender.software''' preference and set it to '''true'''.
# To '''disable''' WebRender, go to '''about:config''' page and look for '''gfx.webrender.force-disabled''' preference and set it to '''true'''.
# Restart browser, check at '''about:support''' for WebRender status.
# Restart browser, check at '''about:support''' WebRender status.
 
== Check Firefox X11 backend ==


== Check Firefox X11 Gtk+ backend (Gnome only) ==
Firefox can run with two independent Gtk+ backends / graphics servers while Wayland is a default one on some distros (Fedora, Ubuntu 20.04+). You can try to switch back to X11 to check if that helps.


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.
On Fedora:


# install firefox-x11 package
# install firefox-x11 package
# close all active firefox instances
# close all active firefox instances
# run '''Firefox on X11''' from menu or '''firefox-x11''' in Terminal
# run '''Firefox on X11''' from menu or '''firefox-x11''' in Terminal
# go to '''about:support''' page, look for '''Window Protocol''' field. You should have '''x11''' there.
On other distros:
# close all active firefox instances
# open terminal
# run '''MOZ_ENABLE_WAYLAND=0 firefox'''
# go to '''about:support''' page, look for '''Window Protocol''' field. You should have '''x11''' there.
== Check Firefox X11 GLX/EGL backend ==
Firefox can run with two independent OpenGL backends - EGL and GLX (details available [https://mastransky.wordpress.com/2021/10/30/firefox-94-comes-with-egl-on-x11/ here]). EGL becomes default in Firefox 94 but you can switch back to GLX in case of issues.
# Go to '''about:support''' page and check '''WebGL 1 Driver''' field. If it contains '''EGL_VENDOR/EGL_VERSION''' you're on '''EGL'''.
# To switch back to '''GLX''', go to '''about:config''' page, look for '''gfx.x11-egl.force-disabled''' and set them to '''true''' and restart browser.


== Collect information for a bug report ==
== Collect information for a bug report ==
Line 73: Line 135:
Please provide those information to your bug report. [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=firefox]
Please provide those information to your bug report. [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=firefox]


If you Firefox crashes, please go to a crash stat page by visiting this link:
* Attach Firefox troubleshooting data. Open Firefox and navigate to:
 
''about:support''
 
page and use '''Copy text to clipboard''' to copy/paste it. Attach the info to bugreport.
 
* Open terminal and run
 
''glxinfo > gfxlog.txt 2>&1''
 
and attach created gfxlog.txt file to the bug. It contains data about your graphics card.
 
* Open terminal and run
 
''vainfo > vainfo.txt 2>&1''
 
and attach created vainfo.txt file to the bug. It contains data about your VA-API video decoder.
 
* If you Firefox crashes, please go to a crash stat page by visiting this link:


  ''about:crashes''
  ''about:crashes''
Line 79: Line 159:
and you should see crash reports ids. Please Submit them at Mozilla by '''Submit All''' button and paste Report IDs to the report at bugzilla.
and you should see crash reports ids. Please Submit them at Mozilla by '''Submit All''' button and paste Report IDs to the report at bugzilla.


If applicable attach a screen cast [https://help.gnome.org/users/gnome-help/stable/screen-shot-record.html.en] or a picture of the issue.
* If applicable attach a '''screen cast''' or a picture of the issue.
 
Screencast in Gnome:
 
''https://help.gnome.org/users/gnome-help/stable/screen-shot-record.html''
 
A popular one is OSB studio:


Attach exact Firefox version, type this command in terminal:
''https://obsproject.com/kb/linux-installation''
''https://obsproject.com/''


''rpm -q firefox''
More screencast info:


Attach firefox troubleshooting data, in the URL bar, visit this link:
''https://www.linuxuprising.com/2020/01/4-tools-to-record-your-linux-desktop.html''


''about:support''
* If you run Fedora attach exact Firefox version, type this command in terminal:


and use '''Copy text to clipboard''' to copy/paste it.
'''rpm -q firefox'''


== Testing Mozilla binaries ==
== Testing Mozilla binaries ==
Line 97: Line 184:
# Download Firefox [https://www.mozilla.org/en-US/firefox/new/]/Thunderbird[https://www.thunderbird.net/en-US/] from Mozilla site directly .
# Download Firefox [https://www.mozilla.org/en-US/firefox/new/]/Thunderbird[https://www.thunderbird.net/en-US/] from Mozilla site directly .
# Unpack the tarball.
# Unpack the tarball.
# 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.
# To run with '''X11 backend''' open terminal, run locally as below, create a new profile and test your issue:
# To use Wayland native backend run as '''MOZ_ENABLE_WAYLAND=1 ./firefox -ProfileManager -no-remote'''. Mozilla thunderbird does not support Wayland yet.
 
'''MOZ_ENABLE_WAYLAND=0 ./firefox -ProfileManager -no-remote'''
 
# To use '''Wayland backend''' run as:
 
'''MOZ_ENABLE_WAYLAND=1 ./firefox -ProfileManager -no-remote'''


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.
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.
Line 108: Line 200:
In case of unexpected Firefox titlebar behavior (missing titlebar, doubled titlebar, missing 'Title Bar' checkbox at Customize menu) try to run Firefox in terminal as:
In case of unexpected Firefox titlebar behavior (missing titlebar, doubled titlebar, missing 'Title Bar' checkbox at Customize menu) try to run Firefox in terminal as:


'''MOZ_GTK_TITLEBAR_DECORATION=client firefox'''
'''MOZ_GTK_TITLEBAR_DECORATION=client firefox'''


and
and


'''MOZ_GTK_TITLEBAR_DECORATION=system firefox'''
'''MOZ_GTK_TITLEBAR_DECORATION=system firefox'''


and check of that helps.
and check of that helps.
Line 120: Line 212:
Mozregression tool [https://mozilla.github.io/mozregression/] can be used to find offending changeset. Install mozregression on terminal by
Mozregression tool [https://mozilla.github.io/mozregression/] can be used to find offending changeset. Install mozregression on terminal by


'''pip install mozregression'''
'''pip install mozregression'''


and run  
and run  


'''mozregression --good version_good --bad version_bad'''
'''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:
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'''
'''mozregression --good 78 --bad 79'''
 
The mozregression tool 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.
 
To test Firefox in Wayland, run mozregression with MOZ_ENABLE_WAYLAND=1 env variable, i.e.:


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.
'''MOZ_ENABLE_WAYLAND=1 mozregression --good 78 --bad 79'''


If you want to test Firefox in Wayland, run mozregression with MOZ_ENABLE_WAYLAND env variable, i.e.:
To test Firefox in XWayland/X11, run mozregression with MOZ_ENABLE_WAYLAND=0 env variable, i.e.:


'''MOZ_ENABLE_WAYLAND=1 mozregression --good 78.0 --bad 79.0'''
'''MOZ_ENABLE_WAYLAND=0 mozregression --good 78 --bad 79'''


If you have a specific profile where the bug happens, you can tell mozregression to use it for testing. For instance I have a  Firefox profile named ''default'' and I want mozregression to use it. First I need to locate the profile files, in my case it's stored at /home/user/.mozilla/firefox/80thyv9a.default (/home/user/.mozilla/firefox is a Firefox profile directory). To test it under Wayland I run:
If you have a specific profile where the bug happens, you can tell mozregression to use it for testing. For instance I have a  Firefox profile named ''default'' and I want mozregression to use it. First I need to locate the profile files, in my case it's stored at /home/user/.mozilla/firefox/80thyv9a.default (/home/user/.mozilla/firefox is a Firefox profile directory). To test it under Wayland I run:


'''MOZ_ENABLE_WAYLAND=1 mozregression --profile /home/user/.mozilla/firefox/80thyv9a.default --profile-persistence clone-first --good 78.0 --bad 79.0'''
'''MOZ_ENABLE_WAYLAND=1 mozregression --profile /home/user/.mozilla/firefox/80thyv9a.default --profile-persistence clone-first --good 78 --bad 79'''


(note the --profile-persistence clone-first parameter to clone the profile before use which protects your data)
(note the --profile-persistence clone-first parameter to clone the profile before use which protects your data)
A different application can be run by '''--app''' parameter. To probe '''thunderbird''' run:
'''mozregression --app thunderbird'''
More info is available at [https://mozilla.github.io/mozregression/documentation/usage.html Mozregression doc page].
== Testing different Wayland compositor ==
Actual Wayland compositor may be source of various bugs. Fedora considers Mutter (Gnome) Wayland compositor as a default one. If you run Firefox on a different compositor (Sway/KWin) please also try to reproduce the bug on Mutter as it helps to sort out Firefox and compositor (Mutter/Sway/KWin) bugs.
You don't need to install whole Gnome environment for it, just install mutter package and run Mutter as a nested compositor on terminal as:
'''mutter --wayland --nested'''
Mutter will create a new Wayland session inside your active one. To run Firefox (and any other Wayland application) there you need to set proper Wayland display by WAYLAND-DISPLAY env variable. You should be already running on 'wayland-0' and the new one (created by nested compositor) may be 'wayland-1' then. So launch Firefox on nested compositor as:
'''WAYLAND_DISPLAY=wayland-1 MOZ_ENABLE_WAYLAND=1 firefox'''
It's also useful to test KDE Plasma compositor (KWin) which can be also run as a nested compositor. For testing I launch it as:
'''kwin_wayland --xwayland --width 1920 --height 1024'''
and then run Firefox as above (with wayland-1 Wayland display set).
== Getting Mozilla crash report from running or frozen Firefox ==
You can kill running application by kill signal and then obtain and submit Mozilla crash stats.
To terminate all firefox instances run on terminal:
<pre>kill -s 11 $(pidof firefox)</pre>
This should terminate all Firefox instances and produce Mozilla crash report dialog. In next Firefox run you should see crash ID at '''about:crashes''' page. Please submit the crash to Mozilla and paste crash ID to bugreport.


== Get system log after system freeze / restart ==
== Get system log after system freeze / restart ==
Line 146: Line 275:
If you suffer from whole system lockups / sudden restart you can examine system log from previous session and look for relevant entries like gfx driver errors, kernel errors or Gnome/Mutter failures. Right after restart run on terminal:
If you suffer from whole system lockups / sudden restart you can examine system log from previous session and look for relevant entries like gfx driver errors, kernel errors or Gnome/Mutter failures. Right after restart run on terminal:


'''journalctl -b -1'''
'''journalctl -b -1'''


It shows a log from previous session, the '-b -1' param tells journalctl to show log from previous boot.
It shows a log from previous session, the '-b -1' param tells journalctl to show log from previous boot.

Revision as of 08:18, 10 May 2023

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.

Verify Firefox installation integrity

Open terminal and run this command:

rpm -qV firefox

If Firefox installation is correct you don't get any output. If there's something printed please re-install Firefox by rpm/dnf on terminal as:

sudo dnf remove firefox
sudo dnf install firefox

Run in safe mode

Safe mode can be used to start Firefox in basic safe configuration. Open terminal and:

  • Make sure no Firefox instance is running. This terminal command:
pidof firefox

should not print any output as it reports PID of running Firefox instances. If you see any running instances please reboot your computer (or use kill/killall command).

  • Launch Firefox in safe mode
firefox --safe-mode

Test Firefox with 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.

If Firefox fails to start with your recent profile and says Firefox is already running you can try to delete lock from your default profile to recover it:

  1. Find a default profile directory (it's usually ~/.mozilla/firefox/xxxxxx.default), you can get it at ~/.mozilla/firefox/profiles.ini file.
  2. Remove 'lock' file for it (when Firefox crashes the profile may be locked).
  3. Try to start Firefox again on terminal, check for any error messages.

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.

Firefox performance issues

There are two sources of possible performance issues - opened site/addon or Firefox itself. To identify hungry site/addon go to

about:performance

page and check for component which uses most of resources.

Firefox internal performance issues can be investigated by Firefox Profiler, go to:

https://profiler.firefox.com/

site and enable Firefox profiling. Please share and attach the profile to bugreport (you can also anonymize it).

Check WebRender state (Hardware acceleration)

WebRender is Firefox hardware accelerated back end which uses OpenGL. It's enabled by default on Gnome/X.org and Gnome/Wayland for Intel/AMD graphics cards. You can try to switch WebRender to software backend to check if that solves your issues.

WebRedner Firefox setup
  1. Go to about:support page and check Compositing field. It's WebRender for hardware/OpenGL rendering and WebRender (Software) for software one.
  2. To disable WebRender hardware backend, go to about:config page and look for gfx.webrender.software preference and set it to true.
  3. Restart browser, check at about:support for WebRender status.

Check Firefox X11 backend

Firefox can run with two independent Gtk+ backends / graphics servers while Wayland is a default one on some distros (Fedora, Ubuntu 20.04+). You can try to switch back to X11 to check if that helps.

On Fedora:

  1. install firefox-x11 package
  2. close all active firefox instances
  3. run Firefox on X11 from menu or firefox-x11 in Terminal
  4. go to about:support page, look for Window Protocol field. You should have x11 there.


On other distros:

  1. close all active firefox instances
  2. open terminal
  3. run MOZ_ENABLE_WAYLAND=0 firefox
  4. go to about:support page, look for Window Protocol field. You should have x11 there.

Check Firefox X11 GLX/EGL backend

Firefox can run with two independent OpenGL backends - EGL and GLX (details available here). EGL becomes default in Firefox 94 but you can switch back to GLX in case of issues.

  1. Go to about:support page and check WebGL 1 Driver field. If it contains EGL_VENDOR/EGL_VERSION you're on EGL.
  2. To switch back to GLX, go to about:config page, look for gfx.x11-egl.force-disabled and set them to true and restart browser.

Collect information for a bug report

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

  • Attach Firefox troubleshooting data. Open Firefox and navigate to:
about:support

page and use Copy text to clipboard to copy/paste it. Attach the info to bugreport.

  • Open terminal and run
glxinfo > gfxlog.txt 2>&1

and attach created gfxlog.txt file to the bug. It contains data about your graphics card.

  • Open terminal and run
vainfo > vainfo.txt 2>&1

and attach created vainfo.txt file to the bug. It contains data about your VA-API video decoder.

  • If you Firefox crashes, please go to a crash stat page by visiting this link:
about:crashes

and you should see crash reports ids. Please Submit them at Mozilla by Submit All button and paste Report IDs to the report at bugzilla.

  • If applicable attach a screen cast or a picture of the issue.

Screencast in Gnome:

https://help.gnome.org/users/gnome-help/stable/screen-shot-record.html

A popular one is OSB studio:

https://obsproject.com/kb/linux-installation
https://obsproject.com/

More screencast info:

https://www.linuxuprising.com/2020/01/4-tools-to-record-your-linux-desktop.html
  • If you run Fedora attach exact Firefox version, type this command in terminal:
rpm -q firefox

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. To run with X11 backend open terminal, run locally as below, create a new profile and test your issue:
MOZ_ENABLE_WAYLAND=0 ./firefox -ProfileManager -no-remote
  1. To use Wayland backend run as:
MOZ_ENABLE_WAYLAND=1 ./firefox -ProfileManager -no-remote

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.

Testing Firefox titlebar

In case of unexpected Firefox titlebar behavior (missing titlebar, doubled titlebar, missing 'Title Bar' checkbox at Customize menu) try to run Firefox in terminal as:

MOZ_GTK_TITLEBAR_DECORATION=client firefox

and

MOZ_GTK_TITLEBAR_DECORATION=system firefox

and check of that helps.

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 --bad 79

The mozregression tool 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.

To test Firefox in Wayland, run mozregression with MOZ_ENABLE_WAYLAND=1 env variable, i.e.:

MOZ_ENABLE_WAYLAND=1 mozregression --good 78 --bad 79

To test Firefox in XWayland/X11, run mozregression with MOZ_ENABLE_WAYLAND=0 env variable, i.e.:

MOZ_ENABLE_WAYLAND=0 mozregression --good 78 --bad 79

If you have a specific profile where the bug happens, you can tell mozregression to use it for testing. For instance I have a Firefox profile named default and I want mozregression to use it. First I need to locate the profile files, in my case it's stored at /home/user/.mozilla/firefox/80thyv9a.default (/home/user/.mozilla/firefox is a Firefox profile directory). To test it under Wayland I run:

MOZ_ENABLE_WAYLAND=1 mozregression --profile /home/user/.mozilla/firefox/80thyv9a.default --profile-persistence clone-first --good 78 --bad 79

(note the --profile-persistence clone-first parameter to clone the profile before use which protects your data)

A different application can be run by --app parameter. To probe thunderbird run:

mozregression --app thunderbird

More info is available at Mozregression doc page.

Testing different Wayland compositor

Actual Wayland compositor may be source of various bugs. Fedora considers Mutter (Gnome) Wayland compositor as a default one. If you run Firefox on a different compositor (Sway/KWin) please also try to reproduce the bug on Mutter as it helps to sort out Firefox and compositor (Mutter/Sway/KWin) bugs.

You don't need to install whole Gnome environment for it, just install mutter package and run Mutter as a nested compositor on terminal as:

mutter --wayland --nested

Mutter will create a new Wayland session inside your active one. To run Firefox (and any other Wayland application) there you need to set proper Wayland display by WAYLAND-DISPLAY env variable. You should be already running on 'wayland-0' and the new one (created by nested compositor) may be 'wayland-1' then. So launch Firefox on nested compositor as:

WAYLAND_DISPLAY=wayland-1 MOZ_ENABLE_WAYLAND=1 firefox

It's also useful to test KDE Plasma compositor (KWin) which can be also run as a nested compositor. For testing I launch it as:

kwin_wayland --xwayland --width 1920 --height 1024

and then run Firefox as above (with wayland-1 Wayland display set).

Getting Mozilla crash report from running or frozen Firefox

You can kill running application by kill signal and then obtain and submit Mozilla crash stats.

To terminate all firefox instances run on terminal:

kill -s 11 $(pidof firefox)

This should terminate all Firefox instances and produce Mozilla crash report dialog. In next Firefox run you should see crash ID at about:crashes page. Please submit the crash to Mozilla and paste crash ID to bugreport.

Get system log after system freeze / restart

If you suffer from whole system lockups / sudden restart you can examine system log from previous session and look for relevant entries like gfx driver errors, kernel errors or Gnome/Mutter failures. Right after restart run on terminal:

journalctl -b -1

It shows a log from previous session, the '-b -1' param tells journalctl to show log from previous boot.

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]