Skip to content

fix: download open-source updates from the GitHub release they are listed in - #2218

Draft
Douglasymlai wants to merge 1 commit into
mainfrom
fix/oss-updater-github-download
Draft

Douglasymlai wants to merge 1 commit into
mainfrom
fix/oss-updater-github-download

Conversation

@Douglasymlai

@Douglasymlai Douglasymlai commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

Problem

If you installed Eigent from a GitHub release, in-app updates never finish. The app shows that a new version is available and starts the download, but the download fails its checksum and the update is never installed.

Cause

The updater reads the new version and its sha512 checksum from the latest*.yml files on the GitHub release. It then downloads the installer from a different location, https://cdn.eigent.ai/releases/v<version>/…, which hosts a different build of the same version. The files differ in size and content, so the checksum from GitHub never matches the downloaded file. For example, the 1.0.8 macOS arm64 zip is 665,885,892 bytes on the GitHub release and 676,773,966 bytes at the other location. 1.0.6 and 1.0.7 show the same mismatch.

Fix

  • By default, update files now download from the same GitHub release the version and checksum came from, using electron-updater's standard GitHub download path. The checksum always describes the file being downloaded.
  • EIGENT_UPDATER_CDN_BASE_URL still works as an opt-in mirror (<mirror>/v<version>/<platform>/<file>) for a mirror that serves the same files as the GitHub release. A blank value means no mirror.
  • Release detection is unchanged: the app still checks the latest GitHub release and the per-platform latest*.yml channels.

Note: installs already on 1.0.8 or earlier still have the old updater. They need a one-time manual download of the release that contains this fix. Updates after that work in-app.

Testing

  • npx vitest run test/unit/electron/githubReleaseCdnProvider.test.ts: 10/10 pass. New cases check the default GitHub download URLs (and that the release's checksums are kept), blank and trailing-slash mirror values, and the mirror path.
  • npm run type-check passes.
  • npx vitest run test/unit/electron: the only failures are 20 in install-deps.test.ts and envUtil.test.ts. The same 20 fail on an unmodified main in this environment, so they are not related to this change.
  • Runtime check (in progress, not yet passed): a signed build of this fix, labeled with an older version, is being updated to the latest GitHub release:
    1. Install the older build from GitHub (the test build) on macOS.
    2. Open Eigent, accept the available update and start the download.
    3. Expect the download to reach 100% and "Restart to update" to appear. After the restart, the version should be the newer release.
    4. ~/Library/Logs/Eigent/main.log should show the file downloading from https://github.com/eigent-ai/eigent/releases/download/v<version>/…, with no sha512 checksum mismatch.

Suggested release note

If you installed Eigent from GitHub and are on 1.0.8 or older, download this release and install it by hand once. In-app updates work from this version on.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant