Skip to content
/ Phoenix Public

Phoenix is a suite of configurations & advanced modifications for Mozilla Firefox, designed to put the user first - with a focus on privacy, security, freedom, & usability.

phoenix.celenity.dev

License

GPL-3.0 license
82 stars 3 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

celenityy/Phoenix

BranchesTags

Repository files navigation

Phoenix

Phoenix

Phoenix is a suite of configurations & advanced modifications for Mozilla Firefox, designed to put the user first - with a focus on privacy, security, freedom, functionality, & usability. A detailed list of Phoenix's features & enhancements can be found here.

Note

While Phoenix's home is Codeberg, this repo is also mirrored to both GitLab & GitHub.

Note

Thunderbird users should consider taking a look at Dove - Phoenix's sister project.

Want to join the Phoenix Community?

We'd love to see you over on Matrix (Recommended) and Discord!

Phoenix works by leveraging Firefox's AutoConfig & Enterprise Policies functionality, and is installed on top of your standard, official Firefox installation. This allows us to go above and beyond what a simple user.js file can offer, without the security risks a fork can introduce. For example, forks often fall behind on Firefox updates, which can leave users open to severe, detrimental vulnerabilities. Phoenix's approach allows users to continue receiving immediate updates, directly from Mozilla.

Phoenix's approach also provides users with a seamless experience that is accessible and easy to use. Gone are the days of creating override files, manually keeping track of updates, resetting old preferences, & adding your user.js file to each and every profile you make. Not only is Phoenix the most effective & comprehensive approach to configuring Firefox, it is also the most accessible & easiest to use.

Phoenix's changes to Firefox are carefully considered based on extensive research & studying of Firefox's inner workings. Phoenix is designed to maintain website compatibility and to avoid breakage as much as possible, while still substantially improving privacy & security compared to vanilla Firefox & most other web browsers. For users who are fine with breakage and want to go even further in enhancing their privacy & security, Phoenix also offers an Extended config. This is completely optional and primarily recommended for advanced users. For more information on Phoenix's compatibility with websites and known issues, please see here.

You should also see here for a comparison between Phoenix, standard Firefox, Arkenfox, Betterfox, LibreWolf, & various other widely used projects of similar nature.

Additionally, Phoenix disables various anti-features & strives to put the user back in control of their browsing experience. Phoenix also includes quality of life enhancements, performance improvements, and other 'goodies' where possible and where it doesn't compromise user privacy or security.

At the end of the day, above all else:

Phoenix is designed from the ground up to always put the user first.

Important

⚠️ All users MUST read the Wiki here before proceeding. The Important & Limitations pages are of extra importance!!

📖Glossary

Click me

💪Motivation

Believe it or not, in the not so distant past, browsers were designed to put the user first. There's a reason that another word to refer to them is user agent...

Sadly, this time has passed. The majority of browser marketshare is now controlled by Google, an ad surveillance company. In all fairness to Google, they do put their customers first - it's just that their customers are the advertisers they siphon data to, not users like you and me. And this is the company behind the engine powering nearly every modern web browser in the world. Talk about a conflict of interest...

Unfortunately, most ot the competition is no better - Just take a look at Microsoft & the 800 ad companies they share your data with...

It doesn't have to be this way.

🚀Install

Important

⚠️ After Phoenix is installed, you MUST restart Firefox after its first run with Phoenix installed. This ensures all of Phoenix's changes are applied...

Phoenix currently provides official support for:

  • Android
  • Arch Linux
  • Debian (& derivatives...)
  • Fedora Linux (39-41)
  • NixOS
  • macOS
  • Ubuntu (& derivatives...)

Other platforms have unfortunately proven difficult to support, though progress is being made. Contributions are always welcome and appreciated.

Note

⚠️ Flatpak (User) & Snap packages of Firefox are currently not supported.

Important

Android users are recommended to install IronFox (Recommended), which uses Phoenix for its configs. Android users can also manually install Phoenix for any Firefox-based browser on Android via the directions here.

Arch

[!NOTE] You can use paru instead of yay with the same options.

Firefox (Pacman):

yay -S phoenix-arch

Firefox (System Flatpak):

yay -S phoenix-flatpak

Debian/Ubuntu & derivatives

Before installing Phoenix, you'll first need to add celenity's OBS repo:

[!NOTE] You may see a warning, such as the following, when updating your apt cache.

Warning: https://download.opensuse.org/repositories/home:/celenity/Debian_12/InRelease: Policy will reject signature within a year, see --audit for details

This is because apt will not support V3 GPG keys after 2026-02-01, and currently the OBS uses a V3 GPG key. For now, there shouldn't be any issues.

echo 'deb https://download.opensuse.org/repositories/home:/celenity/Debian_12/ /' | sudo tee /etc/apt/sources.list.d/home:celenity.list
wget -O- https://download.opensuse.org/repositories/home:celenity/Debian_12/Release.key 2>/dev/null | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/home_celenity.gpg > /dev/null
sudo apt update

Firefox (DEB):

sudo apt install phoenix

Firefox (System Flatpak):

sudo apt install phoenix-flatpak

Firefox-ESR (DEB):

sudo apt install phoenix-esr

Fedora

Before installing Phoenix, you'll first need to add celenity's COPR repo:

sudo dnf copr enable celenity/copr
sudo dnf makecache

Firefox (RPM):

sudo dnf install phoenix

Firefox (System Flatpak):

sudo dnf install phoenix-flatpak

macOS

[!IMPORTANT] ⚠️ Before proceeding, you must have Homebrew installed.

Run the following installation script in your terminal of choice:

/bin/zsh -c "$(curl --cert-status --doh-cert-status --no-insecure --no-proxy-insecure --no-sessionid --no-ssl --no-ssl-allow-beast --no-ssl-auto-client-cert --no-ssl-no-revoke --no-ssl-revoke-best-effort --proto -all,https --proto-default https --proto-redir -all,https --show-error -sSL https://gitlab.com/celenityy/Phoenix/-/raw/pages/installer_scripts/macos_install.sh)"

NixOS

NixOS is supported for flake-based configurations:

  1. Add the Phoenix repository to your flake inputs.
  2. Add phoenix as one of the arguments to your output function.
  3. Add the Phoenix NixOS Module to your configuration.
{
  inputs = {
    # Note that this assumes you have a flake-input called nixpkgs,
    # which is often the case. If you've named it something else,
    # you'll need to change the `nixpkgs` below.
    phoenix = {
      url = "git+https://gitlab.com/celenityy/Phoenix";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };
  # Add the `phoenix` argument to your output function, as below:
  outputs = {nixpkgs, phoenix, ...}: {
	# The configuration here is an example; it will look slightly different
	# based on your machine name and architecture.
    nixosConfigurations.your-box = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";
      modules = [
        # This is the important part -- add this line to your module list!
        phoenix.nixosModules.default
      ];
	};
  };
}

If you would like to use Phoenix on any other unsupported platform, see 📛Manual Installation.

👋Uninstall

Arch

[!NOTE] You can use paru instead of yay with the same options.

Firefox (Standard):

yay -Rcns phoenix-arch

Firefox (System Flatpak):

yay -Rcns phoenix-flatpak

Debian/Ubuntu & derivatives

Firefox (Standard):

sudo apt remove phoenix

Firefox (System Flatpak):

sudo apt remove phoenix-flatpak

Firefox (ESR):

sudo apt remove phoenix-esr

You can also remove celenity's OBS repo if desired:

sudo rm /etc/apt/sources.list.d/home:celenity.list
sudo rm /etc/apt/trusted.gpg.d/home_celenity.gpg
sudo apt update

Fedora

Firefox (Standard):

sudo dnf remove phoenix

Firefox (System Flatpak):

sudo dnf remove install phoenix-flatpak

You can also remove celenity's COPR repo if desired:

sudo dnf copr remove celenity/copr
sudo dnf makecache

macOS

Run the following uninstall script in your terminal of choice:

/bin/zsh -c "$(curl --cert-status --doh-cert-status --no-insecure --no-proxy-insecure --no-sessionid --no-ssl --no-ssl-allow-beast --no-ssl-auto-client-cert --no-ssl-no-revoke --no-ssl-revoke-best-effort --proto -all,https --proto-default https --proto-redir -all,https --show-error -sSL https://gitlab.com/celenityy/Phoenix/-/raw/pages/uninstaller_scripts/macos_uninstall.sh)"

NixOS

?

Please leave us feedback on the way out, so we can improve for the future!

🔥Extended

For advanced users who would like to go above & beyond when protecting their privacy & security, at the cost of occasional breakage, Phoenix offers an Extended config. For a list of features specific to Phoenix Extended, please see here.

Tip

Unlike Phoenix's standard default configuration, Extended is profile-specific. This means that you can use our Extended config as needed when you desire the extra protection, & revert back to Phoenix's standard config through another profile for everything else.

Personally, if you're up for it, I would highly recommend trying out the Extended config, and setting overrides as needed.

Tip

Phoenix makes it very easy to set overrides through your about:config. No more manual override files! ;)

You can see here for a list of known sites that have issues or quirks with Phoenix's Extended config, and what you need to toggle to fix them.

Extended Installation

1: Install Phoenix via the script for your platform of choice above.

2: After installation is complete, locate the Extended user.js file on your device.

Depending on your operating system, it will be located at:

GNU/Linux

Standard:

/etc/firefox/phoenix/userjs/extended/user.js

Flatpak:

/var/lib/flatpak/app/org.mozilla.firefox/current/active/files/etc/firefox/phoenix/userjs/extended/user.js

macOS

Apple Silicon:

/opt/homebrew/opt/phoenix-osx/userjs/extended/user.js

Intel:

/usr/local/opt/phoenix-osx/userjs/extended/user.js

If you use any of the Firefox-UI-Fix CSS skins with Firefox, you should instead use use the user.js file at the following locations:

GNU/Linux

Standard:

/etc/firefox/phoenix/userjs/ui-fix/extended/user.js

Flatpak:

/var/lib/flatpak/app/org.mozilla.firefox/current/active/files/etc/firefox/phoenix/userjs/ui-fix/extended/user.js

macOS

Apple Silicon:

/opt/homebrew/opt/phoenix-osx/userjs/ui-fix/extended/user.js

Intel:

/usr/local/opt/phoenix-osx/userjs/ui-fix/extended/user.js

3: Find your Firefox profile's directory. This depends on your platform, but an easy way to find it is by navigating to about:profiles, and it'll be the path listed beside Root Directory. For example's sake, we'll say our profile's directory is /home/user/.mozilla/firefox/153acxao.default-release. Yours will be different, and you should replace this path on the next step with your actual profile directory's path.

4: Simply move (or copy & paste) your user.js file to your profile's directory! You can either drag and drop it manually, or run the command below. For example's sake, we'll say our user.js is located at /etc/firefox/phoenix/userjs/extended/user.js. Yours may be different, and you should replace this path on the next step with the actual location of your user.js as described above.

cp /etc/firefox/phoenix/userjs/extended/user.js /home/user/.mozilla/firefox/153acxao.default-release/user.js

Congratulations, you're done. Similar to the rest of the Phoenix project, your Extended config will automatically update with the rest of Phoenix via your package manager, and you can set any overrides you wish through the about:config. You can just sit back, relax, and enjoy.

💡Specialized Configs

It should also be noted that Phoenix contains specialized configurations for Apple Maps, Discord, Element, Google Maps, Twitter, and YouTube. These configs are designed to be used in their own, separate Firefox profile, and provide means to safely and easily use these services, like you would any other app on your device.

Important

⚠️ Discord, Google Maps, Twitter, and YouTube are explicitly not recommended for use, due to their privacy-invasive nature. These configs are simply meant to provide harm reduction for users who need to use these services for whatever reason, but it is still best to avoid them entirely if possible.

The installation of these configs is the same as Extended, with the only exception being the location of the user.js file. You can find the location of these user.js files at the following locations:

Apple Maps

GNU/Linux

Standard:

/etc/firefox/phoenix/userjs/apple-maps/user.js

Flatpak:

/var/lib/flatpak/app/org.mozilla.firefox/current/active/files/etc/firefox/phoenix/userjs/apple-maps/user.js

macOS

Apple Silicon:

/opt/homebrew/opt/phoenix-osx/userjs/apple-maps/user.js

Intel:

/usr/local/opt/phoenix-osx/userjs/apple-maps/user.js

Apple Maps (Firefox-UI-Fix)

GNU/Linux

Standard:

/etc/firefox/phoenix/userjs/ui-fix/apple-maps/user.js

Flatpak:

/var/lib/flatpak/app/org.mozilla.firefox/current/active/files/etc/firefox/phoenix/userjs/ui-fix/apple-maps/user.js

macOS

Apple Silicon:

/opt/homebrew/opt/phoenix-osx/userjs/ui-fix/apple-maps/user.js

Intel:

/usr/local/opt/phoenix-osx/userjs/ui-fix/apple-maps/user.js

Discord

GNU/Linux

Standard:

/etc/firefox/phoenix/userjs/discord/user.js

Flatpak:

/var/lib/flatpak/app/org.mozilla.firefox/current/active/files/etc/firefox/phoenix/userjs/discord/user.js

macOS

Apple Silicon:

/opt/homebrew/opt/phoenix-osx/userjs/discord/user.js

Intel:

/usr/local/opt/phoenix-osx/userjs/discord/user.js

Discord (Firefox-UI-Fix)

GNU/Linux

Standard:

/etc/firefox/phoenix/userjs/ui-fix/discord/user.js

Flatpak:

/var/lib/flatpak/app/org.mozilla.firefox/current/active/files/etc/firefox/phoenix/userjs/ui-fix/discord/user.js

macOS

Apple Silicon:

/opt/homebrew/opt/phoenix-osx/userjs/ui-fix/discord/user.js

Intel:

/usr/local/opt/phoenix-osx/userjs/ui-fix/discord/user.js

Element

GNU/Linux

Standard:

/etc/firefox/phoenix/userjs/element/user.js

Flatpak:

/var/lib/flatpak/app/org.mozilla.firefox/current/active/files/etc/firefox/phoenix/userjs/element/user.js

macOS

Apple Silicon:

/opt/homebrew/opt/phoenix-osx/userjs/element/user.js

Intel:

/usr/local/opt/phoenix-osx/userjs/element/user.js

Element (Firefox-UI-Fix)

GNU/Linux

Standard:

/etc/firefox/phoenix/userjs/ui-fix/element/user.js

Flatpak:

/var/lib/flatpak/app/org.mozilla.firefox/current/active/files/etc/firefox/phoenix/userjs/ui-fix/element/user.js

macOS

Apple Silicon:

/opt/homebrew/opt/phoenix-osx/userjs/ui-fix/element/user.js

Intel:

/usr/local/opt/phoenix-osx/userjs/ui-fix/element/user.js

Google Maps

GNU/Linux

Standard:

/etc/firefox/phoenix/userjs/google-maps/user.js

Flatpak:

/var/lib/flatpak/app/org.mozilla.firefox/current/active/files/etc/firefox/phoenix/userjs/google-maps/user.js

macOS

Apple Silicon:

/opt/homebrew/opt/phoenix-osx/userjs/google-maps/user.js

Intel:

/usr/local/opt/phoenix-osx/userjs/google-maps/user.js

Google Maps (Firefox-UI-Fix)

GNU/Linux

Standard:

/etc/firefox/phoenix/userjs/ui-fix/google-maps/user.js

Flatpak:

/var/lib/flatpak/app/org.mozilla.firefox/current/active/files/etc/firefox/phoenix/userjs/ui-fix/google-maps/user.js

macOS

Apple Silicon:

/opt/homebrew/opt/phoenix-osx/userjs/ui-fix/google-maps/user.js

Intel:

/usr/local/opt/phoenix-osx/userjs/ui-fix/google-maps/user.js

Twitter

GNU/Linux

Standard:

/etc/firefox/phoenix/userjs/twitter/user.js

Flatpak:

/var/lib/flatpak/app/org.mozilla.firefox/current/active/files/etc/firefox/phoenix/userjs/twitter/user.js

macOS

Apple Silicon:

/opt/homebrew/opt/phoenix-osx/userjs/twitter/user.js

Intel:

/usr/local/opt/phoenix-osx/userjs/twitter/user.js

Twitter (Firefox-UI-Fix)

GNU/Linux

Standard:

/etc/firefox/phoenix/userjs/ui-fix/twitter/user.js

Flatpak:

/var/lib/flatpak/app/org.mozilla.firefox/current/active/files/etc/firefox/phoenix/userjs/ui-fix/twitter/user.js

macOS

Apple Silicon:

/opt/homebrew/opt/phoenix-osx/userjs/ui-fix/twitter/user.js

Intel:

/usr/local/opt/phoenix-osx/userjs/ui-fix/twitter/user.js

YouTube

GNU/Linux

Standard:

/etc/firefox/phoenix/userjs/youtube/user.js

Flatpak:

/var/lib/flatpak/app/org.mozilla.firefox/current/active/files/etc/firefox/phoenix/userjs/youtube/user.js

macOS

Apple Silicon:

/opt/homebrew/opt/phoenix-osx/userjs/youtube/user.js

Intel:

/usr/local/opt/phoenix-osx/userjs/youtube/user.js

YouTube (Firefox-UI-Fix)

GNU/Linux

Standard:

/etc/firefox/phoenix/userjs/ui-fix/youtube/user.js

Flatpak:

/var/lib/flatpak/app/org.mozilla.firefox/current/active/files/etc/firefox/phoenix/userjs/ui-fix/youtube/user.js

macOS

Apple Silicon:

/opt/homebrew/opt/phoenix-osx/userjs/ui-fix/youtube/user.js

Intel:

/usr/local/opt/phoenix-osx/userjs/ui-fix/youtube/user.js

📛Manual Installation

Caution

This is NOT recommended for most users.

By default, Phoenix is installed & updated via your operating system's package manager. This allows for fast, easy updates & fixes as needed, right with the rest of your system!

However, if this is not desirable for you & your situation, or you would simply like to use Phoenix on an unsupported operating system, you can manually install Phoenix with the following steps:

1: Download phoenix.cfg for your platform:

You can right click and select Save page as from your browser after navigating to the link for your platform's phoenix.cfg, or you can run the following command in your terminal:

Linux:

curl --cert-status --doh-cert-status --no-insecure --no-proxy-insecure --no-sessionid --no-ssl --no-ssl-allow-beast --no-ssl-auto-client-cert --no-ssl-no-revoke --no-ssl-revoke-best-effort --proto -all,https --proto-default https --proto-redir -all,https --show-error -O -sSL https://gitlab.com/celenityy/Phoenix/-/raw/pages/linux/phoenix.cfg

macOS:

curl --cert-status --doh-cert-status --no-insecure --no-proxy-insecure --no-sessionid --no-ssl --no-ssl-allow-beast --no-ssl-auto-client-cert --no-ssl-no-revoke --no-ssl-revoke-best-effort --proto -all,https --proto-default https --proto-redir -all,https --show-error -O -sSL https://gitlab.com/celenityy/Phoenix/-/raw/pages/macos/macos/phoenix.cfg

Windows:

curl --cert-status --doh-cert-status --no-insecure --no-proxy-insecure --no-sessionid --no-ssl --no-ssl-allow-beast --no-ssl-auto-client-cert --no-ssl-no-revoke --no-ssl-revoke-best-effort --proto -all,https --proto-default https --proto-redir -all,https --show-error -O -sSL https://gitlab.com/celenityy/Phoenix/-/raw/pages/windows/phoenix.cfg

2: Download phoenix.js (phoenix-desktop.js for Linux users) for your platform:

You can right click and select Save page as from your browser after navigating to the link for your platform's phoenix.js (or phoenix-desktop.js for Linux users), or you can run the following command in your terminal:

Linux:

curl --cert-status --doh-cert-status --no-insecure --no-proxy-insecure --no-sessionid --no-ssl --no-ssl-allow-beast --no-ssl-auto-client-cert --no-ssl-no-revoke --no-ssl-revoke-best-effort --proto -all,https --proto-default https --proto-redir -all,https --show-error -O -sSL https://gitlab.com/celenityy/Phoenix/-/raw/pages/linux/defaults/pref/phoenix-desktop.js

macOS:

curl --cert-status --doh-cert-status --no-insecure --no-proxy-insecure --no-sessionid --no-ssl --no-ssl-allow-beast --no-ssl-auto-client-cert --no-ssl-no-revoke --no-ssl-revoke-best-effort --proto -all,https --proto-default https --proto-redir -all,https --show-error -O -sSL https://gitlab.com/celenityy/Phoenix/-/raw/pages/macos/defaults/pref/phoenix.js

Windows:

curl --cert-status --doh-cert-status --no-insecure --no-proxy-insecure --no-sessionid --no-ssl --no-ssl-allow-beast --no-ssl-auto-client-cert --no-ssl-no-revoke --no-ssl-revoke-best-effort --proto -all,https --proto-default https --proto-redir -all,https --show-error -O -sSL https://gitlab.com/celenityy/Phoenix/-/raw/pages/windows/defaults/pref/phoenix.js

3: Download policies.json (or org.mozilla.firefox.plist for macOS users) for your platform:

You can right click and select Save page as from your browser after navigating to the link for your platform's policies.json (or org.mozilla.firefox.plist for macOS users), or you can run the following command in your terminal:

Linux:

curl --cert-status --doh-cert-status --no-insecure --no-proxy-insecure --no-sessionid --no-ssl --no-ssl-allow-beast --no-ssl-auto-client-cert --no-ssl-no-revoke --no-ssl-revoke-best-effort --proto -all,https --proto-default https --proto-redir -all,https --show-error -O -sSL https://gitlab.com/celenityy/Phoenix/-/raw/pages/linux/policies/policies.json

macOS:

curl --cert-status --doh-cert-status --no-insecure --no-proxy-insecure --no-sessionid --no-ssl --no-ssl-allow-beast --no-ssl-auto-client-cert --no-ssl-no-revoke --no-ssl-revoke-best-effort --proto -all,https --proto-default https --proto-redir -all,https --show-error -O -sSL https://gitlab.com/celenityy/Phoenix/-/raw/pages/macos/macos/org.mozilla.firefox.plist

Windows:

curl --cert-status --doh-cert-status --no-insecure --no-proxy-insecure --no-sessionid --no-ssl --no-ssl-allow-beast --no-ssl-auto-client-cert --no-ssl-no-revoke --no-ssl-revoke-best-effort --proto -all,https --proto-default https --proto-redir -all,https --show-error -O -sSL https://gitlab.com/celenityy/Phoenix/-/raw/pages/windows/distribution/policies.json

4: Locate your Firefox installation directory. This will vary depending on your platform. An easy way to find it is by navigating to about:support and checking the directory next to Application Binary. For example, on Fedora Linux, I see /usr/lib64/firefox/firefox next to Application Binary. This means our installation directory is /usr/lib64/firefox.

Caution

Unless you're on Fedora Linux, your directory will probably be different, and you should replace this directory on the following steps with your actual installation directory.

5: Move phoenix.cfg to the root of your installation directory. You can either drag and drop it manually, or run the following command for your platform:

Linux/macOS, assuming /usr/lib64/firefox is your installation directory:

sudo cp phoenix.cfg /usr/lib64/firefox/phoenix.cfg

Windows:

cp phoenix.cfg C:\'Program Files'\'Mozilla Firefox'\phoenix.cfg

6: For macOS, Windows, and Flatpak users: If it does not already exist, in the root of your installation directory, create a folder named defaults, and inside this new defaults folder, create another folder titled pref. You can do this manually through your file explorer, or you can run the following command for your platform:

Flatpak/macOS, assuming /usr/lib64/firefox is your installation directory:

sudo mkdir -p /usr/lib64/firefox/defaults/pref

Windows:

mkdir -p C:\'Program Files'\'Mozilla Firefox'\defaults\pref

For standard Linux users: If it does not already exist, you will want to create a folder named firefox located in your system's etc directory. Inside this firefox folder, create a new folder named defaults, and inside this new defaults folder, create another folder titled pref. This will work regardless of your distribution - even Snaps are supported. You can also just run the command below:

sudo mkdir -p /etc/firefox/defaults/pref

On macOS and GNU/Linux, you'll also want to ensure that the folder you created has proper permissions:

Flatpak/macOS, assuming /usr/lib64/firefox is your installation directory:

sudo chmod 744 /usr/lib64/firefox/defaults/pref

For all non-Flatpak GNU/Linux users:

sudo chmod 655 /etc/firefox/defaults/pref

7: Move phoenix.js (or phoenix-desktop.js for Linux users) to the pref folder that you just created. You can run the following command for your platform below:

Linux/macOS, Assuming your installation directory is /usr/lib64/firefox:

sudo cp phoenix-desktop.js /usr/lib64/firefox/defaults/pref/phoenix-desktop.js

Windows:

cp phoenix.js C:\'Program Files'\'Mozilla Firefox'\defaults\pref\phoenix.js

For all non-Flatpak GNU/Linux users:

sudo cp phoenix-desktop.js /etc/firefox/defaults/pref/phoenix-desktop.js

8: On Windows, in the root of your installation directory, create a folder named distribution. You can do this manually through your file explorer, or you can run the following command:

mkdir -p C:\'Program Files'\'Mozilla Firefox'\distribution

non-Flatpak GNU/Linux users should instead create a policies folder inside of the firefox folder located in /etc. This will work regardless of your distribution, and even for Snaps.

sudo mkdir -p /etc/firefox/policies

For non-Flatpak GNU/Linux users, you'll also want to ensure that the folder you created has proper permissions:

sudo chmod 655 /etc/firefox/policies

9: Finally, those on Windows should copy policies.json to the distribution folder that you just created. You can run the following command:

cp policies.json C:\'Program Files'\'Mozilla Firefox'\distribution\policies.json

macOS users should instead copy org.mozilla.firefox.plist to /Library/Preferences, and reboot their device once finished:

sudo cp org.mozilla.firefox.plist /Library/Preferences/org.mozilla.firefox.plist`

GNU/Linux users should instead copy policies.json to their /etc/firefox/policies folder they just created.

sudo cp policies.json /etc/firefox/policies/policies.json

Congratulations, you're done. Enjoy Phoenix, and be sure to keep up with updates!

🤔Using Extended or a Specialized Config Manually

With a manual installation of Phoenix, if you would like to use Phoenix's Extended config, or one of our specialized configs, you'll need to follow these steps.

1: Download the .cfg file of your choice for your platform:

from here. For this example, we'll use youtube.cfg. Simply replace mentions of youtube.cfg below with the configuration you would like to use.

You can right click and select Save page as from your browser on the .cfg file, or you can run the following command in your terminal:

wget https://gitlab.com/celenityy/Phoenix/-/raw/pages/configs/youtube.cfg

2: Store the .cfg file you just downloaded somewhere safe that you can remember. For this example, we'll keep it simple and say I chose to save youtube.cfg at ~/youtube.cfg. Replace mentions of ~/youtube.cfg below with the actual location of your file.

You can either drag and drop the file manually, or run the command below:

cp youtube.cfg ~/youtube.cfg

3: Download the user.js file located here.

You can right click and select Save page as from your browser on the user.js file, or you can run the following command in your terminal:

wget https://gitlab.com/celenityy/Phoenix/-/raw/pages/user.js

4: Edit the user.js file you just downloaded, and replace file://put_your_cfg_file_location_here with the location of your .cfg file from Step 2.

Assuming our file is still located at ~/youtube.cfg and our username is user, we'll change the contents of the user.js file we downloaded to:

user_pref("autoadmin.global_config_url", "file:///home/user/youtube.cfg");

5: Find your Firefox profile's directory. This depends on your platform, but an easy way to find it is by navigating to about:profiles, and it'll be the path listed beside Root Directory. For example's sake, we'll say our profile's directory is /home/user/.mozilla/firefox/153acxao.default-release. Yours will be different, and you should replace this path on the next step with your actual profile directory's path.

6: Simply copy & paste your user.js file to your profile's directory! You can either drag and drop it manually, or run the command below. For example's sake, we'll say our user.js is located at ~/Downloads/user.js. If this is not the path of your downloaded user.js file from Step 3, replace it with its actual location.

cp ~/Downloads/user.js /home/user/.mozilla/firefox/153acxao.default-release/user.js

💜Attribution

Huge thank you to the following projects & individuals for making Phoenix possible. Please show them support!

And of course...

About

Phoenix is a suite of configurations & advanced modifications for Mozilla Firefox, designed to put the user first - with a focus on privacy, security, freedom, & usability.

phoenix.celenity.dev

Topics

firefox security tracking settings privacy browser mozilla speed secure private gecko web-browser hardening mozilla-firefox firefox-browser userjs user-js hardened anti-tracking firefox-based

Resources

Readme

License

GPL-3.0 license
Activity

Stars

82 stars

Watchers

3 watching

Forks

3 forks
Report repository

Releases 42

2025.06.06.1 Latest
Jun 6, 2025
+ 41 releases

Sponsor this project

Contributors 5

Languages