# Cross-platform

{% hint style="warning" %}
**Beware!** Some of the features in this doc are broken or buggy
{% endhint %}

## 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.

* The following software and tools are required for the build process:
  * Git ([git-scm.org](https://git-scm.org))
  * NodeJS ([nodejs.org](https://nodejs.org))
  * yarn ([npmjs.com/package/yarn](https://www.npmjs.com/package/yarn))
  * Docker

{% hint style="warning" %}
Follow steps 1 (Cloning Dot Browser) and 2 (Importing patches) on your host machine and then come back here to start step 3
{% endhint %}

## Supported build targets

| Build target   | Supported? |
| -------------- | ---------- |
| Windows 64-bit | ✅          |
| macOS 64-bit   | ✅          |
| Linux 64-bit   | ✅          |
| Windows 32-bit | ❌          |
| macOS 32-bit   | ❌          |
| Linux 32-bit   | ❌          |

## Building Dot Browser

Now, we're going to want to build Dot Browser for your target OS.

See [Supported build targets](#supported-build-targets) for a list of supported build targets.

 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.

```bash
./melon build <target-os> # target-os could be: windows, macos or linux
```

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.

| OS      | Built binaries                                       |
| ------- | ---------------------------------------------------- |
| Windows | `MOZ_APP_NAME-VERSION-LANGUAGE-win64-installer.exe`  |
| Unix    | `MOZ_APP_NAME-VERSION.LANGUAGE.linux-x86_64.tar.bz2` |

## Running Dot Browser

The final step is to run your cross-built version of Dot Browser.&#x20;

{% hint style="danger" %}
Just remember you **will not** be able to run Windows binaries on Unix based systems like macOS or Linux. And you still might have issues running macOS binaries on Linux and vice-versa.
{% endhint %}

It's as simple as running:

```
./melon run
```

And voilà, Dot should appear before your eyes!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dothq.co/cloning-dot/cross-platform.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.