Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

FireDragon

Latest release Translation status

Welcome to the FireDragon documentation / landing page! :dragon: In here, we collect common information about the browser, as well as known workarounds and troubleshooting stepos.

What is this?

FireDragon is a cross-platform, feature-rich and privacy-focused web browser

FireDragon is based on Firefox with privacy-focused patches and settings from LibreWolf and adds opinionated default settings to improve the out-of-the-box experience and user-friendliness:

  • Dr460nized & Catpuccin editions to visually integrate with Garuda Linux Dr460nized & Mokka respectivly
  • uBlock Origin, Dark Reader & Flagfox Add-Ons installed by default
  • Firefox Sync enabled by default using custom Garuda Linux sync server
  • Lepton skin with custom default configuration

Screenshots

Where to get it?

There are multiple ways to obtain FireDragon on Linux. Windows and MacOSX builds are also available.

  • ArchLinux builds can be obtained in a few ways:

    • Install it via the firedragon AUR package
    • Install it via the firedragon-bin AUR package if you do not wish to compile the package yourself
    • Or use the Chaotic-AUR repository to install and update it with Pacman (maintained by the FireDragon maintainer dr460nf1r3)

  • NixOS builds available at Chaotic-Nyx

    • Either install the flake and put firedragon as any other Nixpkgs package
    • Or run it directly via nix run github:chaotic-cx/nyx/nyxpkgs-unstable#firedragon

  • Flatpak builds can be fetched from FlatHub (Dr460nized edition only) or can be downloaded via our GitLab releases

  • AppImage builds are available via our GitLab releases

  • Binary tarballs for Linux can also be obtained via GitLab releases

  • Windows builds available via GitLab releases

  • MacOSX builds available via GitLab releases

  • The Catppuccin version simply uses -catppuccin following the standard Firedragon package name.

How to understand and use Firedragon Settings

Firedragon is, apart from a few exceptions, a huge set of Firefox config keys.

All configurations that are set by default in Firedragon can be found in our presets.

The files are seperated in Categories and Sections, in which settings are classified. This is not a perfect 1-1 match but most of the time it makes sense to identify.

To understand what each setting means, you have to copy the setting key and search for it in a Search Engine. This sometimes leads to instant description, sometimes it’s much harder, especially when it’s a setting Mozilla did not document.

When you want to change those settings, or add new ones, the best way to do so, at a USER (not root/system!) level, is to use the file firedragon.overrides.cfg. You can create that file in your user’s PROFILE of Firedragon, located in either ~/.firedragon/ (legacy path) or ~/.config/firedragon/ (new xdg dir). And then you follow the same way of setting keys as in librewolf.js/firedragon.js. The overrides file will override only those you specificy in it, it will NOT replace the entire librewolf.js/firedragon.js.

Garuda encourages users to play with those settings, so everyone can customize Firedragon to their liking. If Firefox allows something to be customized, Firedragon should as well.

Have fun!

Firedragon vs Firefox Account Syncing

Firefox has a feature to sync accounts between various devices, like history, opened tabs, passwords


Firedragon also uses this feature but to increase security it uses its own SyncServer.

You have to choose which browser you want to want to sync and set the server properly in the Firedragon config page.

Troubleshooting steps

If you have some issues with Firedragon, follow these steps, remember each result and if the problem persists please post all your results along with the issue.

  • Close the browser before trying anything else
  • Create a new profile by opening the terminal and typing
firedragon -P
  • Proceed by creating the new profile and launching from it to test your issue
  • If the issue persists, try using the included troubleshooting tool at about:firedragon-troubleshooting. The UI will look quite different (if not, you got a profile corruption) then test your issue.

If after all these steps you still get the same issue, then it is very most likely not Firedragon related, and you should open a help Request on the Garuda Forum or the Floorp github. If you stop getting the issue at one of those steps, please provide details on the Garuda Forum, so we might be able to fix for everyone. Firedragon is in essence “not a browser”. In reality, it is a few patches to the source code combined with some config files (the most important being /usr/lib/firedragon/firedragon.cfg). The very most of what makes Firedragon “Firedragon” is found in this file. This is why testing without the file at all is a good indication of next steps.

Workarounds and Known Issues

Issues on twitch.tv

See this issue for reference: click me

Add-ons and Settings menus broken

See https://forum.garudalinux.org/t/firedragon-broken-after-117-update/38762. Possible fix is to set to false the config widget.wayland.fractional-scale.enabled in about:config

TABs loaded in Background

This is not an issue, but by design. By default Firedragon loads tabs in the background. Some people may not like this, therefore you can change the setting browser.tabs.loadDivertedInBackground to FALSE.

Websites Crashing after a certain time of usage (example web.whatsapp.com)

This is not a technical issue, it is related to how PSD (profile-sync-daemon) works. The explanation and possible solutions are found in here

Changelogs

Overview

Starting with version 11.17.4, when something is worth mentioning, Changelogs will be found here.

11.17.4 (August 20, 2024)

  • Major upgrade to Firefox ESR 128 as a base, through Floorp 11.17.
  • Some settings in firedragon.cfg where polished out to ensure better browsing compatibility without sacrifying security/privacy too much. These changes also include old deprecated settings and potentially a few new ones.
  • New Tab button is now emulating a Tab, through the config userChrome.tab.newtab_button_like_tab.
  • Firedragon specific configs are now identified in firedragon.cfg. When scrolling through the settings, those applied by the Firedragon team are identified with –> FIREDRAGON CONFIG in its line. This is a work in progress so it is not extensive and probably will never identify 100% of them, but from v11.17.4 they will be.
  • Added the extension Flagfox. This is currently the only Active privacy feature Firedragon has, meaning the user can see and act according to a situation Firedragon (Flagfox) is presenting. Flagfox allows to display a flag in the URLBAR when you hover the mouse in the bar, letting the user know where the website’s server is geolocated. Based on that value, the user can decide whether or not to continue browsing on that website. Flagfox offers more features in its Settings.
  • Following the deprecation of Floorp’s User Agent Settings section, a new User Agent is provided in Firedragon, spoofing Chrome 129 on Windows 10. This should allow excellent website compatibility.

11.17.6 (August 22, 2024)

  • In 11.17.4 we changed the User Agent for one Floorp was using. At the same time they deprecated their section where you could select which browser/OS you want to spoof. Turns out using one of those was causing various compatiblity issues for many people. It seems more and more websites try to identify what your browser really is and if you spoof something different than Firefox (in Firedragon’s case), some may find this suspicious and block various features of their website. In 11.17.4 we were spoofing Chrome. We now changed this back to Firefox 126.

Reference

12.1.1 (August 27, 2025)

  • This version is a major upgrade following the 11 series.

Reference

Team

Who are we?

This is the team of awesome people who are creating FireDragon for you:

How to contact us?

If you want to contact us due to any reason, be it suggestions or bug reports, please the issues section of the settings repository on GitLab.

You may also create a thread in the Garuda forum, we have a dedicated section for FireDragon issues. Team members are present here as well.

Credits

Creating this browser woudln’t have been possible without those people and projects:

  • Mozilla (creators of the original Firefox browser)
  • Arch Linux (spent a lot of time creating PKGBUILDs this browser came from early on)
  • The Floorp project, used as base for this browser
  • The Librewolf project, where a lot of the privacy enhancing tweaks originate from
  • torvic9 & his retired Plasmafox, has also been an inspiration early on
  • vnepogodin, who helped debugging issues and provided a lot of useful information
  • ptr1337, who also contributed a lot of helpful fixes and information and now works on Cachy Browser with vnepogodin
  • SGS & zoeruda, who both contributed beautiful artwork to FireDragon