The latest development version of this page may be more current than this released 2.0.0 version.

Install macOS Host Dependencies

Important

Go back to the main Getting Started Guide when you’re done here.

This section describes how to set up a Zephyr development environment on macOS.

These instructions have been tested on the following macOS versions:

  • Mac OS X 10.11 (El Capitan)
  • macOS Sierra 10.12

Update Your Operating System

Before proceeding with the build, ensure your OS is up to date.

Install Requirements and Dependencies

Zephyr requires Python 3, while macOS only provides a Python 2 installation. After following these instructions, the version of Python 2 provided by macOS in /usr/bin/ will sit alongside the Python 3 installation from Homebrew in /usr/local/bin.

First, install Homebrew by following instructions on the Homebrew site. Homebrew is a free and open-source package management system that simplifies the installation of software on macOS. While installing Homebrew, you may be prompted to install additional missing dependencies; please follow any such instructions as well.

Now install these host dependencies with the brew command:

brew install cmake ninja gperf ccache dfu-util qemu dtc python3

Additional notes for MacPorts users

While MacPorts is not officially supported in this guide, it is possible to use MacPorts instead of Homebrew to get all the required dependencies on macOS. Note also that you may need to install rust and cargo for the Python dependencies to install correctly.