How to set up the Firefox OS desktop build

This article is no longer maintained, so its content might be out of date.

Running the Firefox OS Simulator can be very useful for developers, tinkerers, and curious minds wanting to get a feel for how the Firefox OS operates.

Note: The Firefox OS Simulator add-on for Firefox was formerly known as r2d2b2g.

Use the Firefox OS Simulator add-on

Running the Firefox OS add-on for the Firefox browser is the quickest and easiest way to get it working in under a minute, and it works on Windows, Mac, and Linux.

Install the Firefox OS Simulator

Please follow these easy steps to install and run the Firefox OS Simulator add-on for Firefox:

  1. Open your Firefox browser.
  2. Open this link to the Firefox OS Simulator add-on.
  3. Click on the button + Add to Firefox. Firefox will download the requested add-on and ask you to confirm that you want to install it.
  4. Click on the button Install – the add-on will be installed.

Run the Firefox OS Simulator

  1. At the top of the Firefox window, click on the Firefox button.At the top of the Firefox window, click on the Tools menu.At the top of the Firefox window, click on the Tools menu (on Ubuntu in the menu bar, click on Tools).On the menu bar, click on the Tools menu.
  2. Go over to the Web Developer menu, and click Firefox OS Simulator.
  3. On the left side of the simulator window, click on the switch Stopped so that it will turn to Running.

The simulator will start and you may now start playing with Firefox OS!
Tip: Use the home or fn+left arrow buttons on your keyboard to simulate the home button on the device.
Note: For more detailed information, you can read more about Using the Firefox OS Simulator on the Mozilla Developer Network.


These fine people helped write this article:

Illustration of hands


Grow and share your expertise with others. Answer questions and improve our knowledge base.

Learn More