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