IronFox

F-Droid QR Code:

---

IronFox is a fork of Divested Computing Group's Mull Browser, based on Mozilla Firefox. Our goal is to continue the legacy of Mull by providing a free and open source, privacy and security-oriented web browser for daily use.

Important

⚠️ All users are HIGHLY recommended to take a look at our documentation, ESPECIALLY the Limitations and Frequently Asked Questions pages!

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

Want to join the IronFox Community?

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

App Installation

For details and step-by-step instructions on how to install IronFox, see our Installation page.

App Verification

Package ID: org.ironfoxoss.ironfox

Package ID (Nightly): org.ironfoxoss.ironfox.nightly

SHA-256 Hash of Signing Certificate:

C5:E2:91:B5:A5:71:F9:C8:CD:9A:97:99:C2:C9:4E:02:EC:97:03:94:88:93:F2:CA:75:6D:67:B9:42:04:F9:04

Building

IronFox makes it easier (and faster) to build the project locally. For example, prebuilt versions of wasi-sdk sysroot and llvm-project are used instead of building them locally. F-Droid builds still build those from source.

It is recommended to use the Docker image for building IronFox.

Build with Docker

Pull the docker image with :

docker pull registry.gitlab.com/ironfox-oss/ironfox:latest

You can also use the main tag to pull the image which was used to build the latest IronFox release. Or you can use exact version names to pull images for those versions.

For example:

docker pull registry.gitlab.com/ironfox-oss/ironfox:v135-0

Then, you need to set up the source files.

Build without Docker

NOTE: Currently, builds on the latest versions of Fedora, macOS, secureblue, and Ubuntu systems are supported. YMMV for other operating systems/environments.

NOTE: macOS users must install Homebrew (if is not already installed) before following the steps below.

First, if you haven't already installed it, you'll want to install git for your platform of choice:

Fedora:

sudo dnf install git

macOS:

brew install git

secureblue:

git is already installed on secureblue by default, so nothing to do here.

Ubuntu:

sudo apt install git

After you've successfully installed git, the first thing you'll need to do is clone IronFox's source repository:

(--depth=1 is specified below to reduce the size of the cloned repository, it can be removed if preferred)

git clone --depth=1 git@gitlab.com:ironfox-oss/IronFox.git IronFox

You should now navigate to the root of IronFox's source directory, and run the bootstrap script:

(The bootstrap script will set-up and install dependencies required to build IronFox on your system)

cd IronFox
./scripts/bootstrap.sh

Get sources

Still from the root of IronFox's source directory, you should now run the get_sources script to download the external sources required for building IronFox:

NOTE: If you need to fetch sources for a different version of a dependency than the version IronFox is currently using, you'll need to modify scripts/versions.sh BEFORE running the get_sources script.

This may take some time depending on your network speed...

./scripts/get_sources.sh

Preparing sources

You now need to patch/prepare your newly downloaded sources with the prebuild script:

This must be run once after getting your sources.

./scripts/prebuild.sh <build-variant>

Where <build-variant> specifies the variant to build, and is one of the following:

• arm - 32-bit ARM (armeabi-v7a)
• arm64 - 64-bit ARM (arm64-v8a)
• x86_64 - 64-bit x86
• bundle - Android App Bundle (AAB) with all supported ABIs.

Important

If you want to build the bundle variant locally, you need to build the ABI-specific variants first, get the generated AAR file for GeckoView and then configure MOZ_ANDROID_FAT_AAR* environment variables with the path to the generate AAR files.

See task kinds and ci-build.sh for more details.

Build

Finally, you can start the build process with:

./scripts/build.sh apk

NOTE: If you'd like to build a bundle, you should instead use:

./scripts/build.sh bundle

Translation

IronFox is translated using Weblate. Visit the Weblate project to help with translations.

Licensing

The scripts are licensed under the GNU Affero General Public License, version 3 or later.

Changes to patches are licensed according to the header in the files this patch adds or modifies (Apache 2.0 or MPL 2.0).

Phoenix is licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later) where applicable. See COPYING.

a-c-liberate.patch, a-c-localize-maven.patch, a-s-localize-maven.patch, fenix-liberate.patch, gecko-localize-maven.patch, and microg-unbreak-fido.patch are adapted from Fennec F-Droid. See COPYING.

gecko-custom-ublock-origin-assets.patch, gecko-prevent-exposing-name-and-vendor-to-extensions.patch, and gecko-rs-blocker.patch are adapted from LibreWolf. See LibreWolf License and Disclaimers.

fenix-disable-network-connectivity-monitoring.patch, gecko-disable-network-id.patch, geckoview-ironfox-settings-support-spoof-english.patch, and glean-noop.patch are adapted from the Tor Project. See LICENSE.

Our current set of default wallpapers are taken from Fennec F-Droid, and are available under the Unsplash license.

Notices

Mozilla Firefox is a trademark of The Mozilla Foundation.

This is not an officially supported Mozilla product. IronFox is in no way affiliated with Mozilla.

IronFox is not sponsored or endorsed by Mozilla.

IronFox is not associated with DivestOS, Divested Computing Group, or Mull in any manner.

Firefox source code is available at https://github.com/mozilla-firefox/firefox.