Skip to main content

Auto-Updater

Desktop applications include automatic update functionality via electron-updater.

How It Works​

Update Sources​

SourceConfiguration
GitHub ReleasesDefault β€” checks repo releases
Custom ServerSelf-hosted update server
S3 BucketAWS 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​

  1. Check β€” polls update server on startup and periodically
  2. Download β€” downloads update package in background
  3. Verify β€” validates checksum and signature
  4. Prompt β€” notifies user of available update
  5. Install β€” applies update (may require restart)

Code Signing​

Updates require code-signed builds to pass OS security:

PlatformSigning
WindowsAuthenticode certificate (.pfx)
macOSApple Developer ID + notarization
LinuxNot required (AppImage)

Version Strategy​

Semantic versioning: MAJOR.MINOR.PATCH

Pre-release channels:

  • latest β€” stable releases
  • alpha β€” pre-release builds