Project Intro | Wiki | Contribute
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
Thunderbird users should consider taking a look at Dove - Phoenix's sister project.
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.
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
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 of 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.
We'd love to see you over on Matrix (Recommended) and Discord!
| Platform | Derivatives | Firefox Support | Support Status |
|---|---|---|---|
| Android | - | IronFox | Official |
| Arch | Partial | Firefox | Official + Community |
| Debian | Yes | Firefox: bin, ESR | Official |
| Fedora | No | Firefox | Official |
| Flatpak | - | org.mozilla.firefox | Broken |
| Gentoo | Yes | Firefox: bin, source | Community |
| NixOS | - | Firefox | Official + Community |
| macOS | - | Firefox | Official |
| Ubuntu | Yes | Firefox | Official |
| Windows | - | Firefox, Zen | Partial |
Also see: Repology.
Important
See: Install.md
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.
See: Extended.md
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.
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 follow this tutorial:
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:
See: Using Extended or a Specialized Config Manually.md
You can help by contributing code or by telling others about Phoenix. Reach out to us and let us know how you want to help.
- Build instructions: wiki/build.md
Phoenix is licensed under the
GNU General Public License v3.0 or later
(GPL-3.0-or-later) where applicable.
This is not an officially supported Mozilla product. Phoenix is in no way affiliated with Mozilla.
Phoenix is not sponsored or endorsed by Mozilla.
Huge thank you to the following projects & individuals for making Phoenix possible. Please show them support!
| Projects & Names | Notes | License | Donate |
|---|---|---|---|
| Seyed Mohamad Amin Modaresi | Designed Phoenix's icon (derived from Xonotic, see below), created the install & uninstall scripts, helped with maintenance/packaging, assisted with README formatting, provided general advice & support, and responsible for various other significant contributions. | - | - |
| GW72 | Invaluable feedback and support of the project. | - | - |
| Xonotic: Severin Meyer | Designed Phoenix's icon | GPLv3 or later | - |
| Arkenfox: Thorin-Oakenpants, earthlng, claustromaniac | - | MIT | - |
| Betterfox: yokoffing | Certain preferences (Mostly performance-related) | MIT | Donate |
| Narsil's mozilla.cfg: Narsil | Certain preferences + inspiration | GPLv3 | - |
| Brace: Divested Computing Group | Certain preferences + inspiration | AGPLv3 | - |
| LibreWolf: bgstack15, fxbrit, Malte Jürgens, ohfp, James McClain, threadpanic, Guillaume | Inspiration + certain preferences & policies | MPL-2.0 | - |
| firefox-config: rusty-snake | Inspiration + certain preferences | CC0 | - |
| uBlock Origin: Raymond Hill, ItsProfesssional, MasterKia, peace2000, Peter Lowe, PiQuark6046, stephenhawk8054 | Pre-installed extension - provides content blocking | GPLv3 | - |
| Mullvad DNS: Mullvad VPN AB | Default DNS Over HTTPS Resolver | - | Donate |
| And of course... Firefox: Mozilla | - | MPL-2.0 | Donate |
⭐ If you like this project, please consider giving it a star!