Skip to content

Add bootstrapper checksums for 2.9.0 and 2.9.1 - #2650

Merged
glopesdev merged 1 commit into
bonsai-rx:mainfrom
glopesdev:add-missing-bootstrapper-checksums
Jul 28, 2026
Merged

glopesdev merged 1 commit into
bonsai-rx:mainfrom
glopesdev:add-missing-bootstrapper-checksums

Conversation

@glopesdev

Copy link
Copy Markdown
Member

The knownChecksums table in EnvironmentSelector had static entries only up to 2.8.5, plus a dynamic entry for the version of the running launcher. A local environment pinned to a released version with no entry is rejected outright, so opening a workflow in a project pinned to 2.9.0 would fail with an unhandled ApplicationException under the 2.9.1 launcher. Adding the two entries makes those environments start their own bootstrapper again, downloading it first when the executable is not already present.

How the values were obtained

Each value is the SHA256 of the Bonsai.exe inside the Bonsai.zip release asset for that version, which is the file DownloadBootstrapperExecutableAsync compares against after extracting the archive. To reproduce, per version:

curl -L -o Bonsai.zip https://github.com/bonsai-rx/bonsai/releases/download/2.9.0/Bonsai.zip
unzip -o Bonsai.zip Bonsai.exe
sha256sum Bonsai.exe

bonsai --info prints the resolved bootstrapper path, version and checksum for the current directory without launching or downloading anything. To check the behaviour, run this command in a project whose .bonsai/Bonsai.config pins 2.9.0. The bootstrapper will report an empty checksum before this change and the new value after.

What this does not fix

Launchers already installed at 2.9.1 carry the incomplete table, so they keep rejecting 2.9.0 environments until they are updated. The workaround in the meantime is to place the 2.9.0 Bonsai.exe in the .bonsai folder and run it directly rather than through the installed launcher.

Closes #2649

Opening a workflow in a local environment pinned to 2.9.0 or 2.9.1 now
starts that bootstrapper, downloading it if needed, instead of failing
as an unsupported version.

Closes bonsai-rx#2649
@glopesdev glopesdev added this to the 2.9.2 milestone Jul 28, 2026
@glopesdev
glopesdev requested a review from a team July 28, 2026 13:59
@glopesdev glopesdev added the fix Pull request that fixes an issue label Jul 28, 2026
@glopesdev
glopesdev merged commit 55df51f into bonsai-rx:main Jul 28, 2026
10 checks passed
@glopesdev
glopesdev deleted the add-missing-bootstrapper-checksums branch July 28, 2026 15:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

fix Pull request that fixes an issue

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Missing bootstrapper checksum entry makes the 2.9.1 launcher reject environments pinned to 2.9.0

1 participant