Skip to main content

Building Floorp on Windows

danger

We cannot provide support if a build fails. Please understand this before proceeding with the following steps.

📦 Requirements​

Machine Specifications​

  • Memory: Minimum 4GB RAM, 8GB+ recommended.
  • Disk Space: At least 40GB of free disk space.
  • Operating System: Windows 10 or later. You should update to the latest version of Windows.

Required Tools​

  • Mozilla Build Shell
    Mozilla Build Shell is a set of tools that includes the MinGW-w64 toolchain.
    It is used to build Floorp on Windows.
    This provides a Linux-like environment on Windows.

  • git
    git is a version control system. It is used to download the Floorp & Firefox source code.

📦 Build Floorp​

  1. Open Mozilla Build Shell.
C:\mozilla-build\start-shell.bat
  1. Clone the Floorp repository.
git clone https://github.com/Floorp-Projects/Floorp.git
git submodule update --init --recursive
  1. Run the following command to install the dependencies. Before building Floorp, you need to select a build option. Please choose the following:

[1] Build Floorp for Desktop.

The other choices are not supported yet. The next selection depends on your choice.

cd Floorp
./mach bootstrap
  1. Run the following command to build Floorp.
// Create mozconfig
echo 'ac_add_options --with-branding=browser/branding/official' >> mozconfig
echo 'ac_add_options --with-app-basename=Floorp' >> mozconfig
echo 'ac_add_options --with-app-name=floorp' >> mozconfig
echo "ac_add_options --enable-bootstrap" >> mozconfig

// build Floorp
./mach configure
./mach build
  1. Run the following command to run Floorp.
./mach run

Congratulations! You have successfully built Floorp!