Dot HQ
WebsiteDiscordTwitterBrowser Repository
main
main
  • 📚Dot HQ Documentation
  • 🏗️Building Dot Browser
    • 🏁Windows
    • 🐧Linux
    • 🍎macOS
    • 🤝Cross-platform
    • ❗Common issues
  • 🧩Components
  • 📝Making changes to Dot
Powered by GitBook
On this page
  • First things first...
  • Clone the repository
  • Downloading the source code and mounting
  • Importing the patches
  • Building Dot Browser
  • Running Dot Browser

Was this helpful?

  1. Building Dot Browser

Windows

This is a step by step guide on how to build Dot Browser on the world's most popular operating system, Windows.

PreviousBuilding Dot BrowserNextLinux

Last updated 3 years ago

Was this helpful?

First things first...

  • Minimum requirements:

    • 8GB of RAM

      • 4 physical CPU cores

      • 20GB of disk space free

  • Recommended requirements:

    • 16GB of RAM

      • 8 physical CPU cores

      • 35GB of disk space free

  • You'll need to be on a 64-bit operating system to clone and build Dot Browser.

    • Don't know if your computer is 64-bit? (You can ).

    • Optionally, The Windows 10 ISO is downloadable through the

  • The following software and tools are required for the build process:

    • Git ()

    • MozillaBuild CLI ()

    • Visual Studio ()

    • Docker ()

    • Python 2.7 and 3.9 ()

    • Rust ()

    • Node.JS ()

      • Yarn (npm i -g yarn)

      • Typescript (npm i -g typescript)

  • Select the following settings in Visual Studio Installer:

    • Desktop development with C++

    • Game development with C++

    • Windows 10 SDK (version 10.0.17134.0 or higher)

Dot Browser is based on Firefox, which is why it is referenced a lot in the build process.

Clone the repository

We're now going to clone Dot Browser.

git clone https://github.com/dothq/browser-desktop.git
git clone git@github.com:/dothq/browser-desktop.git

Or if you prefer using GitLab:

git clone https://gitlab.com/dothq/browser-desktop.git
git clone git@gitlab.com:dothq/browser-desktop.git

After the clone is complete, you'll want to enter the browser-ff directory in Git Bash.

Downloading the source code and mounting

To download and set up the source code, run the following commands in Git Bash:

./melon download
./windows-init.sh

melon is a build toolkit for Dot Browser.

Importing the patches

Next, you're going to want to import the patches. You can do this by running the command below in Git Bash.

./melon import

If everything went smoothly with the import, you should see a "success" message.

If you see an error saying that a patch failed due to different line endings, run ./melon fix-le in Git Bash and try again.

Building Dot Browser

Now, we're going to want to build Dot Browser for Windows.

It's a very resource intensive process so make sure you check the requirements against your computer. It usually takes between 30 minutes and an hour for computers meeting the recommended requirements.

To start the build, open a MozillaBuild terminal and cd into browser-ff. To start the build, run these commands in MozillaBuild:

cd src
MOZCONFIG=../configs/windows/mozconfig ./mach build

If you get an error about missing required dependencies, you can install them by running ./melon download-artifacts in Git Bash.

Once the build is done, we need to make sure the build was successful. Check to see if something appeared like:

01:00:00 Your build was successful!

If you see that message, you can move on to the final step.

Running Dot Browser

The final step is to run your locally-built version of Dot Browser.

It's as simple as entering the src folder and running:

./mach run

And voilà, Dot should appear before your eyes!

The Windows build process is still a work-in-progress. If you encounter any issues, please .

🏗️
🏁
check here
Installation Media tool
git-scm.org
mozilla.org
visualstudio.microsoft.com
docker.com
python.org
rust-lang.org
nodejs.org
open an issue on our GitHub repository
It's magic! ✨