electron-builder 0,12,0,3,5,0,9,6 editorconfig travis-ci circleci npm

A complete solution to package and build a ready for distribution Electron app with “auto update” support out of the box

electron-builder npm version downloads per month donate

A complete solution to package and build a ready for distribution Electron app for macOS, Windows and Linux with “auto update” support out of the box.

  • NPM packages management:
  • Code Signing on a CI server or development machine.
  • Auto Update ready application packaging.
  • Numerous target formats:
    • All platforms: 7z, zip, tar.xz, tar.lz, tar.gz, tar.bz2, dir (unpacked directory).
    • macOS: dmg, pkg, mas.
    • Linux: AppImage, snap, debian package (deb), rpm, freebsd, pacman, p5p, apk.
    • Windows: nsis (Installer), nsis-web (Web installer), portable (portable app without installation), AppX (Windows Store), Squirrel.Windows.
  • Two package.json structure is supported, but you are not forced to use it even if you have native production dependencies.
  • Build version management.
  • Publishing artifacts to GitHub Releases, Amazon S3 and Bintray.
  • Pack in a distributable format already packaged app.
  • Separate build steps.
  • Build and publish in parallel, using hard links on CI server to reduce IO and disk space usage.
  • electron-compile support (compile for release-time on the fly on build).
Question Answer
“I want to configure electron-builder” See options
“I have a question” Open an issue or join the chat
“I found a bug” Open an issue
“I want to donate” Donate with Donorbox or Paypal

Real project example — onshape-desktop-shell.

Yarn is strongly recommended instead of npm.

Note: Platform specific 7zip-bin-* packages are optionalDependencies, which may require manual install if you have npm configured to not install optional deps by default.

Quick Setup Guide

  1. Specify the standard fields in the application package.jsonname, description, version and author.

  2. Specify the build configuration in the package.json as follows:

    "build": {
      "appId": "your.id",
      "mac": {
        "category": "your.app.category.type"

    See all options.

  3. Create a directory build in the root of the project and save a background.png (macOS DMG background), icon.icns (macOS app icon) and icon.ico (Windows app icon) into it.

The Linux icon set will be generated automatically based on the macOS icns file (or you can put them into the build/icons directory if you want to specify them yourself. The filename must contain the size (e.g. 32x32.png) of the icon).

  1. Add the scripts key to the development package.json:

    "scripts": {
      "pack": "build --dir",
      "dist": "build"

    Then you can run npm run dist (to package in a distributable format (e.g. dmg, windows installer, deb package)) or npm run pack (only generates the package directory without really packaging it. This is useful for testing purposes).

    To ensure your native dependencies are always matched electron version, simply add "postinstall": "install-app-deps" to your package.json.

  2. If you have native addons of your own that are part of the application (not as a dependency), add "nodeGypRebuild": true to the build section of your development package.json.
    :bulb: Don’t use npm (neither .npmrc) for configuring electron headers. Use node-gyp-rebuild bin instead.

  3. Installing the required system packages.

Please note that everything is packaged into an asar archive by default.

For an app that will be shipped to production, you should sign your application. See Where to buy code signing certificates.

Auto Update

electron-builder produces all required artifacts, for example, for macOS:

  • .dmg: macOS installer, required for the initial installation process on macOS.
  • -mac.zip: required for Squirrel.Mac.

See the Auto Update section of the Wiki.


CLI Usage

Execute node_modules/.bin/build --help to get the actual CLI usage guide.

  --mac, -m, -o, --macos   Build for macOS, accepts target list (see
                           https://goo.gl/HAnnq8).                       [array]
  --linux, -l              Build for Linux, accepts target list (see
                           https://goo.gl/O80IL2)                        [array]
  --win, -w, --windows     Build for Windows, accepts target list (see
                           https://goo.gl/dL4i8i)                        [array]
  --x64                    Build for x64                               [boolean]
  --ia32                   Build for ia32                              [boolean]
  --armv7l                 Build for armv7l                            [boolean]
  --dir                    Build unpacked dir. Useful to test.         [boolean]
  --extraMetadata, --em    Inject properties to package.json (asar only)
  --prepackaged, --pd      The path to prepackaged app (to pack in a
                           distributable format)
  --projectDir, --project  The path to project directory. Defaults to current
                           working directory.
  --config, -c             The path to an electron-builder config. Defaults to
                           `electron-builder.yml` (or `json`, or `json5`), see

  --publish, -p  Publish artifacts (to GitHub Releases), see
                           [choices: "onTag", "onTagOrDraft", "always", "never"]
  --draft        Create a draft (unpublished) release                  [boolean]
  --prerelease   Identify the release as a prerelease                  [boolean]

  --platform  The target platform (preferred to use --mac, --win or --linux)
                      [choices: "mac", "win", "linux", "darwin", "win32", "all"]
  --arch      The target arch (preferred to use --x64 or --ia32)
                                                 [choices: "ia32", "x64", "all"]

  --help     Show help                                                 [boolean]
  --version  Show version number                                       [boolean]

  build -mwl                    build for macOS, Windows and Linux
  build --linux deb tar.xz      build deb and tar.xz for Linux
  build --win --ia32            build for Windows ia32
  build --em.foo=bar            set package.json property `foo` to `bar`
  build --config.nsis.unicode=false  configure unicode options for NSIS

Programmatic Usage

See node_modules/electron-builder/out/electron-builder.d.ts. Typings is supported.

"use strict"

const builder = require("electron-builder")
const Platform = builder.Platform

// Promise is returned
  targets: Platform.MAC.createTarget(),
  config: {
   "//": "build options, see https://goo.gl/ZhRfla"
  .then(() => {
    // handle result
  .catch((error) => {
    // handle error

Pack Only in a Distributable Format

You can use electron-builder only to pack your electron app in a AppImage, Snaps, Debian package, NSIS, macOS installer component package (pkg) and other distributable formats.

./node_modules/.bin/build --prepackaged <packed dir>

--projectDir (the path to project directory) option also can be useful.


electron-builder on Slack (please use threads). Public archive without registration.

Further Reading

See the Wiki for more documentation.

Related Repositories



A complete solution to package and build a ready for distribution Electron app with “auto update” support out of the box ...



grunt plugin to ease the building of atom-shell based applications ...



Complete solution to build ready for distribution and "auto update" installers of your app for OS X and Windows (Linux can be supported too). ...



Complete solution to package and deploy Electron apps ...



Complete solution to package and deploy Electron apps ...

Top Contributors

develar stefanjudis demetris-manikas xseignard mkaz vQuagliaro Lange greenkeeperio-bot havenchyk maxcnunes vxsx radibit daB0bby null9beta Frondor djpereira freewil Toflar pauliusuza alchaplinsky championswimmer citrusui nono fyockm etiktin meltedspark ha-D jasonhinkle avoidwork worldjoe


package version
7zip-bin ^2.1.0
ajv ^5.2.2
ajv-keywords ^2.1.0
archiver ^2.0.0
aws-sdk ^2.94.0
bluebird-lst ^1.0.2
chalk ^2.0.1
chromium-pickle-js ^0.2.0
cuint ^0.2.2
debug ^2.6.8
electron-download-tf 4.3.1
electron-is-dev ^0.3.0
electron-osx-sign 0.4.6
fcopy-pre-bundled 0.3.4
fs-extra-p ^4.4.0
hosted-git-info ^2.5.0
ini ^1.3.4
is-ci ^1.0.10
isbinaryfile ^3.0.2
js-yaml ^3.9.1
lodash.isequal ^4.5.0
mime ^1.3.6
minimatch ^3.0.4
node-emoji ^1.8.1
normalize-package-data ^2.4.0
parse-color ^1.0.0
plist ^2.1.0
read-config-file ^0.1.3
sanitize-filename ^1.6.1
semver ^5.4.1
source-map-support ^0.4.15
stat-mode ^0.2.2
ts-jsdoc ^2.0.3
tunnel-agent ^0.6.0
update-notifier ^2.2.0
uuid-1345 ^0.99.6
xelement ^1.0.16
yargs ^8.0.2
dev @types/ini ^1.3.29
@types/jest ^20.0.5
@types/js-yaml ^3.9.0
@types/source-map-support ^0.4.0
@types/xml2js ^0.4.0
babel-preset-ts-node4-bluebird ^0.1.0
convert-source-map ^1.5.0
decompress-zip ^0.3.0
depcheck ^0.6.7
develar-typescript-json-schema 0.17.0
electron-builder-tslint-config ^1.0.3
env-paths ^1.0.0
globby ^6.1.0
jest-cli ^20.0.4
jest-environment-node-debug ^2.0.0
jest-junit ^2.1.0
jsdoc-to-markdown ^3.0.0
path-sort ^0.1.0
shebang-loader ^0.0.1
ts-babel ^3.1.4
tslint ^5.5.0
typescript ^2.4.2
v8-compile-cache ^1.1.0
whitespace ^2.1.0
worker-farm ^1.4.1
xml2js ^0.4.17


-   v7.10.0 zip tar
-   v7.9.0 zip tar
-   v7.8.0 zip tar
-   v7.7.0 zip tar
-   v7.6.0 zip tar
-   v7.5.0 zip tar
-   v7.4.0 zip tar
-   v7.3.0 zip tar
-   v7.2.0 zip tar
-   v7.1.0 zip tar
-   v7.0.1 zip tar
-   v7.0.0 zip tar
-   v6.7.7 zip tar
-   v6.7.6 zip tar
-   v6.7.5 zip tar
-   v6.7.4 zip tar
-   v6.7.3 zip tar
-   v6.7.2 zip tar
-   v6.7.1 zip tar
-   v6.7.0 zip tar
-   v6.6.1 zip tar
-   v6.6.0 zip tar
-   v6.5.2 zip tar
-   v6.5.1 zip tar
-   v6.5.0 zip tar
-   v6.4.1 zip tar
-   v6.4.0 zip tar
-   v6.3.5 zip tar
-   v6.3.4 zip tar
-   v6.3.3 zip tar