Skip to content

Troubleshooting

Filip Š edited this page Jan 26, 2022 · 5 revisions

If the site installation fails because of a manifest-related error, you can try disabling the use of manifest for determining app properties and installing the site again. If this fixes the issue, it is very likely (but not necessary) a problem with the site and I cannot fix it. If the issue remains, read below.

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, preferably the 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 a new enough glibc version installed.
  3. Open the JavaScript console and check for any errors. If the problem happens in an 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 an 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), ~/.local/share/firefoxpwa (Linux) or ~/Library/Application Support/firefoxpwa (macOS) directory. 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.