Auto-Updater
Desktop applications include automatic update functionality via electron-updater.
How It Worksβ
Update Sourcesβ
| Source | Configuration |
|---|---|
| GitHub Releases | Default β checks repo releases |
| Custom Server | Self-hosted update server |
| S3 Bucket | AWS S3 with update metadata |
Configurationβ
GitHub Releasesβ
// electron-builder.yml
publish:
provider: github
owner: ever-co
repo: ever-gauzy
Custom Serverβ
publish:
provider: generic
url: https://updates.yourdomain.com
Update Processβ
- Check β polls update server on startup and periodically
- Download β downloads update package in background
- Verify β validates checksum and signature
- Prompt β notifies user of available update
- Install β applies update (may require restart)
Code Signingβ
Updates require code-signed builds to pass OS security:
| Platform | Signing |
|---|---|
| Windows | Authenticode certificate (.pfx) |
| macOS | Apple Developer ID + notarization |
| Linux | Not required (AppImage) |
Version Strategyβ
Semantic versioning: MAJOR.MINOR.PATCH
Pre-release channels:
latestβ stable releasesalphaβ pre-release builds
Related Pagesβ
- Desktop Overview
- Desktop Builds β building releases
- GitHub Actions β CI for releases