# Desktop Auto-Updater Deep Dive {#desktop-auto-updater-deep-dive}


Automatic update mechanism for the Gauzy Desktop application.


## Overview {#overview}


The auto-updater uses Electron Builder's built-in update mechanism, which supports:

- GitHub Releases (default)
- Custom update server
- S3/DigitalOcean Spaces


## Update Flow {#update-flow}






```mermaid
sequenceDiagram
    Desktop->>UpdateServer: Check for updates
    UpdateServer-->>Desktop: New version available
    Desktop->>User: Show update notification
    User->>Desktop: Accept update
    Desktop->>UpdateServer: Download update
    UpdateServer-->>Desktop: Update package
    Desktop->>Desktop: Install & restart
```






## Configuration {#configuration}


```json
{
  "publish": {
    "provider": "github",
    "owner": "ever-co",
    "repo": "ever-gauzy"
  }
}
```


## Update Channels {#update-channels}


| Channel | Purpose           |
| ------- | ----------------- |
| latest  | Stable releases   |
| beta    | Beta testing      |
| alpha   | Early development |


## Platform-Specific {#platform-specific}


| Platform | Update Format   | Auto-Install |
| -------- | --------------- | ------------ |
| Windows  | `.exe` NSIS     | Yes          |
| macOS    | `.dmg` / `.zip` | Yes (signed) |
| Linux    | `.AppImage`     | Yes          |


## Manual Check {#manual-check}


Users can trigger an update check: **Settings** → **About** → **Check for Updates**


## Related Pages {#related-pages}


- [Desktop Overview](https://sourcey-gauzy.pages.dev/desktop/desktop-overview/index.md) — desktop guide
- [Desktop Builds](https://sourcey-gauzy.pages.dev/desktop/desktop-builds/index.md) — build process
- [Release Process](https://sourcey-gauzy.pages.dev/development/release-process/index.md) — releases