Setup Progressive Web Apps for Firefox

  • License Agreement
  • Connector Installation
  • Runtime Installation
  • Ready

The project is licensed under the Mozilla Public License 2.0. By using, redistributing, or modifying it, you must agree to the license, and the additional clauses provided below. See the LICENSE file in the project repository for the full MPL 2.0 license text.


The project uses additional third-party assets and code:

Additional open source software will be downloaded and installed at runtime when initiated by the user:

  • Installing the runtime on Windows will install 7-Zip if it is not already installed. The 7-Zip project is made by Igor Pavlov and licensed under the GNU LGPL license and others. This project is not affiliated with the 7-Zip project or its developers in any way.
  • Installing the runtime on any system will download the unmodified Mozilla Firefox browser and locally modify it. By using this project, you also agree to the Firefox Privacy Notice. Firefox is licensed under the Mozilla Public License 2.0. Firefox and the Firefox logo are trademarks of the Mozilla Foundation in the U.S. and other countries. This project is not affiliated with the Mozilla Foundation in any way.

This extension exchanges personal data (current website and manifest URLs, as well as other PWA details) with the native program when the user initiates the PWA installation. This is necessary in order to correctly obtain and parse the Web Application Manifest and install the PWA. Data are stored on the computer as long as that PWA is installed. No personal data leave the computer or are sent to third parties.

You need to install the additional program so the extension can manage and run separate runtime and profiles for your web apps. The extension will not work without this program. Please follow the instructions below to install it.

Error: The version of a currently-installed program may be incompatible with the current version of the extension. You need to update the program or the extension to a compatible version to make them work correctly.

  • Extension version:
  • Native version:

Error:

This extension also needs a separate Mozilla Firefox runtime where all your Progressive Web App sites will run. Pressing the button below will automatically download the unmodified Mozilla Firefox from the Mozilla servers and locally modify it with the required modifications. You can also check the advanced options below to manually install the runtime.

This extension also needs a separate Mozilla Firefox runtime where all your Progressive Web App sites will run. However, your platform currently does not support automatic installation of the runtime. Please follow the advanced options below to install it manually.

To install the runtime, you will need 7-Zip installed. Installing the runtime will automatically trigger the 7-Zip installer if needed. This may require accepting User Account Control prompt. You can also manually install 7-Zip or use your existing 7-zip installation. After the runtime is installed, you can delete 7-Zip manually.

After the runtime is installed, you should be automatically proceeded to the next step. If nothing changes after around 30 seconds, restart the browser.

Error:

Advanced options
Manually installing Firefox from the archive:
  1. Download the Firefox archive from your preferred source (for example, from the official downloads page).
  2. Extract the downloaded archive and copy files to the correct directory (see below).
Manually installing Firefox using package manager:
  1. Install Firefox using your distro's package manager (e.g., sudo apt install firefox, sudo yum install firefox, ...).
  2. Copy the installed Firefox files (commonly stored in /usr/lib/firefox/) to the correct directory (see below).
Installing an alternative Firefox-based browser (for example, LibreWolf):
  1. Download the "portable" archive (binary tarball) for your preferred Firefox-based browser.
  2. Extract downloaded archive and copy files to the correct directory (see below).
  3. Inside that directory, symlink the main binary of your browser (for example, librewolf.exe/librewolf-bin) as firefox.exe/firefox.
Default runtime locations:
  • Windows: %APPDATA%\FirefoxPWA\runtime\
  • Linux: $XDG_DATA_HOME/firefoxpwa/runtime/ or $HOME/.local/share/firefoxpwa/runtime/
  • macOS: $HOME/Library/Application Support/firefoxpwa/runtime/

This extension is now ready to be used. You can close this page.