Binary Verification
Every release publishes the archives, a SHA256SUMS file and a Minisign signature. Verify the signature before you trust the checksums.
What a release contains
- One archive per platform, named
voxeltron-0.1.3-<platform>.tar.gz. - Platforms:
linux-x86_64,linux-arm64anddarwin-arm64. - Linux archives hold
voxeltrond,vxlandvxl-admin. The macOS archive holdsvxlonly. SHA256SUMSandSHA256SUMS.minisig.- The release notes for that version.
Download your platform's archive, SHA256SUMS and SHA256SUMS.minisigfrom the 0.1.3 GitHub release.
Verify by hand
Install Minisign from your distribution or from the upstream project, then verify the checksum file:
The release public key is RWTK4dWYTyVbrgcV0LOIXqg6p6RQECLoyMXoLGZt6e9NcOzW33vpwu7+ (minisign key ID AE5B254F98D5E1CA). Download it from this site, not from the release you are checking:
$ curl -fsSLo voxeltron-release.pub https://voxeltron.dev/release-key.txt
$ minisign -Vm SHA256SUMS -p voxeltron-release.pub
$ sha256sum -c SHA256SUMS --ignore-missingMinisign prints the trusted comment. It must read Trusted comment: voxeltron v0.1.3; any other version means the file belongs to another release. On macOS, useshasum -a 256 -c SHA256SUMS --ignore-missing. A failure from either command means do not install the archive.
Check that the public key matches the one on this page, and did not come from the archive you are verifying. A key shipped inside the archive proves nothing.
Verify through the installer
The published site installer takes no flags. Always setVOXELTRON_VERSION=0.1.3 to select the exact release.
$ curl -fsSLo install.sh https://voxeltron.dev/install.sh
$ less install.sh
$ sudo env VOXELTRON_VERSION=0.1.3 sh ./install.shThe site installer has the release public key built in and prints it before downloading. It verifies SHA256SUMS.minisig with that key and requires its trusted comment to name the version being installed. Only then does it download the archive and check it againstSHA256SUMS. It installs nothing if any check fails.
Which archive
| Host | Archive |
|---|---|
| Linux x86_64 | voxeltron-0.1.3-linux-x86_64.tar.gz, daemon and CLI. |
| Linux arm64 | voxeltron-0.1.3-linux-arm64.tar.gz, daemon and CLI. |
| macOS arm64 | voxeltron-0.1.3-darwin-arm64.tar.gz, CLI only. |
Do not run an archive for another target. The installer rejects a platform it cannot install, including macOS on Intel.