Configure and build Fuchsia

This guide provide instructions on how to set up and build Fuchsia.

The steps are:

  1. Prerequisites.
  2. Set your build configuration.
  3. Speed up the build (Optional).
  4. Build Fuchsia.

1. Prerequisites

Source code

Before you start, complete the Download the Fuchsia source code guide to download the Fuchsia source code and set up the Fuchsia development environment on your machine.

Hardware requirements

Fuchsia can only be built on a machine with one of the following CPU architecture and operating system combinations:

  • x86-64 Linux (Debian-based distributions only)
  • x86-64 macOS

Windows and ARM64 Linux are not supported.

ARM64 macOS is not officially supported, but a build may still succeed if commands are run in a terminal started with:

arch -x86_64 /bin/zsh

2. Set your build configuration

Fuchsia's build configuration informs the build system which product to build and which architecture to build for.

To set your Fuchsia build configuration, run the following fx set command:

Replace the following:

  • PRODUCT: The Fuchsia product that you want to build; for example, core and workstation.
  • BOARD: The architecture of the product; for example, x64 and qemu-x64

The example command below sets a build configuration that builds the core product for the Fuchsia emulator (FEMU):

fx set core.qemu-x64

In this example:

  • core is a product with the minimum feature set of Fuchsia, including common network capabilities.
  • qemu-x64 is a board that refers to the x64 architecture on FEMU, which is based on the open source emulator QEMU.

Additionally, the example command below sets your build configuration to build Fuchsia's workstation product for an x64 architecture machine or device:

Note: For more information on Workstation, see Build Workstation.

fx set workstation.x64

For more information on the build configuration, see Configure a build.

3. Speed up the build (Optional)

Note: This step is not required to build Fuchsia, but it's recommended since it can save you a lot of time when you build Fuchsia.

To speed up the Fuchsia build, you can use one of the following services:

Enable Goma

Goma{:.external} is a distributed compiler service for open source projects such as Chrome, Android and Fuchsia.

If you have access to Goma, enable a Goma client on your machine:

fx goma

Install ccache

If you do not have access to Goma, but want to accelerate the Fuchsia build locally, use ccache{:.external} to cache artifacts from previous builds.

  • {Linux}

    To use ccache on Linux, install the following package:

    sudo apt-get install ccache
    
  • {macOS}

    For macOS, see Using CCache on Mac{:.external} for installation instructions.

ccache is enabled automatically if your CCACHE_DIR environment variable refers to an existing directory.

To override this default behavior, specify the following flags to fx set:

  • Force the use of ccache even when other accelerators are available:

  • Disable the use of ccache:

4. Build Fuchsia

The fx build command executes the build to transform source code into packages and other build artifacts.

To build Fuchsia, run the following command:

Note: Building Fuchsia can take up to 90 minutes.

fx build

When you modify source code, run the fx build command again to perform an incremental build, or run the fx -i build command to start a watcher, which automatically builds whenever you update the source code.

For more information on building Fuchsia, see Execute a build.

Next steps

To launch the Fuchsia emulator (FEMU) on your machine, see Start the Fuchsia emulator.

However, if you want to run Fuchsia on a hardware device, see Install Fuchsia on a device instead.