Electron Documentation1.6.1

Docs / Development / Build Instructions (macOS)

Build Instructions (macOS)

Follow the guidelines below for building Electron on macOS.


If you are using the Python downloaded by Homebrew, you also need to install the following Python modules:

Getting the Code

$ git clone https://github.com/electron/electron


The bootstrap script will download all necessary build dependencies and create the build project files. Notice that we’re using ninja to build Electron so there is no Xcode project generated.

$ cd electron
$ ./script/bootstrap.py -v


Build both Release and Debug targets:

$ ./script/build.py

You can also only build the Debug target:

$ ./script/build.py -c D

After building is done, you can find Electron.app under out/D.

32bit Support

Electron can only be built for a 64bit target on macOS and there is no plan to support 32bit macOS in the future.


To clean the build files:

$ npm run clean


See Build System Overview: Tests

See something that needs fixing? Propose a change on the source.
Need a different version of the docs? See the available versions or community translations.
Want to search all the documentation at once? See all of the docs on one page.