A free service that makes it easy for open-source Electron apps to update themselves.
Before using this service, make sure your Electron app meets these criteria:
- Your app runs on macOS or Windows
- Your app has a public GitHub repository
- Your builds are published to GitHub Releases
- Your builds are code signed (macOS only)
Install update-electron-app as a runtime dependency (not a devDependency):
npm install update-electron-app --saveCall it from in your main process file:
require('update-electron-app')()And that's all it takes! To customize, see the update-electron-app API.
Once your application is packaged, it will update itself for each new GitHub Release that you publish.
Use something like the following setup to add automatic updates to your application:
Important: Please ensure that the code below will only be executed in your packaged app, and not in development. You can use electron-is-dev to check for the environment.
const { app, autoUpdater } = require('electron')Next, construct the URL of the update server and tell autoUpdater about it:
const server = 'https://update.electronjs.org'
const feed = `${server}/OWNER/REPO/${process.platform}-${process.arch}/${app.getVersion()}`
autoUpdater.setFeedURL(feed)As the final step, check for updates. The example below will check every 10 minutes:
setInterval(() => {
autoUpdater.checkForUpdates()
}, 10 * 60 * 1000)Once your application is packaged, it will update itself for each new GitHub Release that you publish.
You'll first need to have a running Redis server. There are two options:
- Locally: Install Redis locally and run it directly with
redis-server. Guides can be found here. - Docker: Install and run Redis with
docker run -p 6379:6379 -it redis/redis-stack-server:latest.
$ yarn
$ GH_TOKEN=TOKEN npm startTo try with an actual electron app, run:
$ yarn start &
$ cd example
$ yarnOn Darwin:
$ npm run build
$ ./out/test-darwin-x64/test.app/Contents/MacOS/testOn Windows:
$ npm run build
$ "example\out\make\squirrel.windows\x64\test-0.0.0 Setup.exe"
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent