Google is committed to advancing racial equity for Black communities. See how.

Set up the emulator

You can set up and run Fuchsia in an emulator, also called FEMU.

Prerequisites

To run FEMU, you must have

Configure network

For Fuchsia's ephemeral software to work in the emulator, you need to configure an IPv6 network.

Linux

To enable networking in FEMU, run the following commands:

sudo ip tuntap add dev qemu mode tap user $USER
sudo ip link set qemu up

macOS

You need to install TunTap, kernel extensions that allow macOS to create virtual network interfaces.

For macOS 10.9 (Mavericks) and 10.10 (Yosemite), install TunTap using this installation package.

For macOS 10.13 (High Sierra) and later versions, do the following:

  1. Install Homebrew:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
    
  2. Install TunTap:

    brew cask install tuntap
    

The installation of TunTap may fail at first. In that case, do the following:

  1. Open System Preferences.
  2. Open Security & Privacy and select theGeneral tab.
  3. Next to the System software from developer "Mattias Nissler" was blocked from loading. message, click Allow (see Apple's User-Approved Kernel Extension Loading for details).
  4. Run the install command again:

    brew cask install tuntap
    

After installing TunTap, run the following command:

sudo chown $USER /dev/tap0

Start the emulator

To start the emulator with networking enabled, run the following command:

fx emu -N

Next steps

For next steps on using FEMU, see the Running the Fuchsia Emulator guide.