Skip to content

Installation Directories

Executables

Global system directory for the main executable files. Contains the main firefoxpwa executable that handles the command-line features and launches web apps.

On Windows, also contains the firefoxpwa-connector executable that handles native messaging connections from the browser extension, and the native app manifest. On Linux and macOS, they are located at the appropriate locations for that platform.

Can be overwritten by a FFPWA_EXECUTABLES build- or run-time environment variable.

Warning

Changing this variable to another directory also requires modifying the installation scripts to install executables into that directory and set the correct native app manifest path.

Default Location:

  • Windows: C:\Program Files\FirefoxPWA\ (can be set during installation)
  • PortableApps.com: #{root}\App\PWAsForFirefox\
  • Linux: /usr/bin/
  • macOS & BSD: /usr/local/bin/
  • Homebrew: #{prefix}/bin/

Required Permissions:

  • Read

Main Executable

Default Location:

  • Windows: C:\Program Files\FirefoxPWA\firefoxpwa.exe
  • PortableApps.com: #{root}\App\PWAsForFirefox\firefoxpwa.exe
  • Linux: /usr/bin/firefoxpwa
  • macOS & BSD: /usr/local/bin/firefoxpwa
  • Homebrew: #{prefix}/bin/firefoxpwa

Connector Executable

Default Location:

  • Windows: C:\Program Files\FirefoxPWA\firefoxpwa-connector.exe
  • PortableApps.com: #{root}\App\PWAsForFirefox\firefoxpwa-connector.exe
  • Linux: /usr/libexec/firefoxpwa-connector
  • macOS & BSD: /usr/local/libexec/firefoxpwa-connector
  • Homebrew: #{prefix}/libexec/firefoxpwa-connector

Note

The connector executable is not installed in the main executables directory on systems other than Windows.

System Data

Global system directory for the project data. Stores the UserChrome modifications which are later copied to the user-specific profile directories at the web-app-launch-time.

On Windows, also contains the shell completions files. On Linux and macOS, they are located at the appropriate locations for that platform.

When using PortableApps.com or when manually chosen by the user, this directory can also contain the runtime.

Can be overwritten by a FFPWA_SYSDATA build- or run-time environment variable.

Warning

Changing this variable to another directory also requires modifying the installation scripts to install system project data into that directory.

Default Location:

  • Windows: C:\Program Files\FirefoxPWA\ (can be set during installation)
  • PortableApps.com: #{root}\App\PWAsForFirefox\
  • Linux: /usr/share/firefoxpwa/
  • macOS & BSD: /usr/local/share/firefoxpwa/
  • Homebrew: #{prefix}/share/

Required Permissions:

  • Read

UserChrome

Default Location:

  • Windows: C:\Program Files\FirefoxPWA\userchrome\
  • PortableApps.com: #{root}\App\PWAsForFirefox\userchrome\
  • Linux: /usr/share/firefoxpwa/userchrome/
  • macOS & BSD: /usr/local/share/firefoxpwa/userchrome/
  • Homebrew: #{prefix}/share/userchrome/

Completions

Default Location:

  • Windows: C:\Program Files\FirefoxPWA\completions\
  • PortableApps.com: Not installed by default
  • Linux & macOS & BSD: Appropriate locations for shells

User Data

User-specific directory for the project data. Stores the internal Firefox instance, profile directories with user data, web app icons (on Windows), as well as the configuration and log files.

Can be overwritten by a FFPWA_USERDATA build- or run-time environment variable.

Default Location:

  • Windows: %APPDATA%\FirefoxPWA\
  • PortableApps.com: #{root}\Data\
  • Linux & BSD: ${XDG_DATA_HOME:="$HOME/.local/share"}/firefoxpwa/
  • macOS: $HOME/Library/Application Support/firefoxpwa/

Required Permissions:

  • Read
  • Write

Runtime

Default Location:

  • Windows: %APPDATA%\FirefoxPWA\runtime\
  • PortableApps.com: #{root}\App\PWAsForFirefox\runtime\
  • Linux & BSD: ${XDG_DATA_HOME:="$HOME/.local/share"}/firefoxpwa/runtime/
  • macOS: $HOME/Library/Application Support/firefoxpwa/runtime/

Note

The runtime is not installed in the user data directory when using PortableApps.com package to comply with PortableApps.com packaging guidelines about not having binary files in the data directory.

Note

If the runtime is not already installed to the user data directory, the program will also attempt to use the runtime from the system data directory. In this case, you need to make sure the directory is writeable by all users to make the patching work.

Profiles

Default Location:

  • Windows: %APPDATA%\FirefoxPWA\profiles\
  • PortableApps.com: #{root}\Data\profiles\
  • Linux & BSD: ${XDG_DATA_HOME:="$HOME/.local/share"}/firefoxpwa/profiles/
  • macOS: $HOME/Library/Application Support/firefoxpwa/profiles/