GitHub

The GitHub target publishes all your artifacts to GitHub releases, this allows your users to download the files straight from your repository or if your repository is open source you can use update.electronjs.org and get a free hosted update service.

Configuration options are documented in PublisherGitHubConfig

info

You can use this target to publish to GitHub Enterprise using the host configuration options of octokitOptions. Check out the configuration options linked above.

Usage

forge.config.js

module.exports = {
  // ...
  publishers: [
    {
      name: "@electron-forge/publisher-github",
      config: {
        repository: {
          owner: "me",
          name: "awesome-thing",
        },
        prerelease: true,
      },
    },
  ],
};

Auto updating from GitHub

Updating from a GitHub release for a public repository is as simple as adding the update-electron-app module to your app's main process.

main.js

const { updateElectronApp } = require("update-electron-app");
updateElectronApp(); // additional configuration options available

If your GitHub release is in a private repository, you should check our Auto Update guide for alternative solutions.