Comment on page
🍎
macOS
This is a step by step guide on how to build Dot Browser on macOS.
- 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.
- If typing
uname -m
into a terminal returnsx86_64
you are on a 64-bit computer.
- The following software and tools are required for the build process:
- Docker
Dot Browser is based on Firefox, which is why it is referenced a lot in the build process.
We're now going to clone Dot Browser.
git clone https://github.com/dothq/browser-ff
Or if you prefer using GitLab:
git clone https://gitlab.com/dothq/browser-ff
After the clone is complete, you'll want to enter the
browser-ff
directory.Now run
./melon download
This will download the source code.melon
is a build toolkit for Dot Browser.Once you've downloaded the source code, you're going to want to import the patches. You can do this by running the command below.
./melon import
If everything went smoothly with the import, you should see a "success" message.
Now, we're going to want to build Dot Browser for macOS.
It's a very resource intensive process so make sure you check the requirements against your computer. It usually takes 30 minutes for computers in the recommended requirements region.
./melon build
The build runs inside a Docker container so it is separate from your actual machine.
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.
The final step is to run your locally-built version of Dot Browser.
It's as simple as running:
./melon run
And voilà, Dot should appear before your eyes!

It's magic! ✨
Last modified 2yr ago