Skip to content

Troubleshooting

Filip Š edited this page Jul 4, 2021 · 5 revisions

If you encounter any problems while using the extensions, here are some steps that can help you troubleshoot and debug the problem. Please save any debug info or logs and provide them when reporting an issue.

  1. Make sure the extension and the native program are using the same, prefferably latest, version.
  2. If you are on Windows, make sure you have the Visual C++ Redistributable package installed. If you are on Linux, make sure you have new enough glibc version installed.
  3. Open JavaScript console and check for any errors. If the problem happens in a extension tab (e.g., install or update page), you can view it by pressing F12 and switching to the Console tab. If the problem happens in a extension popup, you can view it by navigating to about:debugging#/runtime/this-firefox and inspecting the extension. You may need to repeat the same action that caused problems again for errors to show.
  4. Create an empty DEBUG file (with no file extension) in the %APPDATA%\FirefoxPWA (Windows) or ~/.local/share/firefoxpwa (Linux). Then, repeat an action that caused problems and check log files, firefoxpwa.log, firefoxpwa-stdout.log and firefoxpwa-stderr.log in the same directory.
  5. If you cannot determine and fix the problem yourself, please open a new issue and provide all required information. If you were able to fix the problem but you think the same problem might happen to other users, you can still report it (and tell how you fixed it) so other users with the same problem can fix it easily.
Clone this wiki locally