Desktop updates
Recover from a stuck download or restart and understand supported update paths.
Seira checks for updates in the background and offers the download in a card at the bottom of the window. How the download is applied depends on what you installed.
| Build | What the button does |
|---|---|
| macOS, Windows, Linux AppImage | Restart to update — the app replaces itself and reopens. An AppImage is always rewritten at the path you launch, so your launcher, symlink or dock pin keeps working. |
| Snap and Flatpak | The store updates the app. Seira shows no update button for these builds. |
The download keeps spinning
Leave the app open long enough for one complete attempt, then quit and reopen it. A failed differential update should fall back to the full package. If the same release remains stuck, download the current installer from the official releases page and install it over the existing copy.
On macOS, Preparing update is a separate step after the download finishes. macOS must stage the update before Restart to update becomes available. A completed download does not mean this preparation is finished.
If an update fails, its error stays visible instead of being replaced by a background update check. If a restart is taking longer than expected, quit the app completely before trying again; repeatedly clicking Restart cannot speed it up.
Restart to update does nothing
Quit Seira completely and launch it again. If the version did not change, install the latest release manually. Your conversations and settings live outside the application bundle and are not removed by replacing the app.
On Linux, an AppImage that updates from an older version can install the update and then stay closed. Open Seira again from your app menu. The new version is already in place.
The installed version runs the updater, not the version being downloaded. If you are upgrading from an older build with a stuck updater, you may need to install the new version manually once to receive the fix. Do not delete your Seira data directory.
Report an update failure
Open App settings → General → Diagnostics → Export Diagnostics…. Include your operating system, the currently installed version, the target version, and whether the failure happened during download, preparation, or restart. Newer builds include a bounded, redacted updater log alongside the server and desktop logs. Review the exported file before sharing it privately with support.
Verify the installed version
Open App settings and check the displayed version. A commit merged to main is not in the desktop app until a release workflow publishes a new version.
Use official artifacts
Do not install update files forwarded through chat or uploaded to an unrelated repository. Use the Seira releases repository and its checksums.