Development Environment Setup on macOS


This section only describes OS-specific setup instructions; it is the first step in the complete Zephyr Getting Started Guide.

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.

After Homebrew is successfully installed, install the following tools using the brew command line tool in the Terminal application.

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