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-arm64 and darwin-arm64.
  • Linux archives hold voxeltrond, vxl and vxl-admin. The macOS archive holds vxl only.
  • SHA256SUMS and SHA256SUMS.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-missing

Minisign 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.sh

The 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

HostArchive
Linux x86_64voxeltron-0.1.3-linux-x86_64.tar.gz, daemon and CLI.
Linux arm64voxeltron-0.1.3-linux-arm64.tar.gz, daemon and CLI.
macOS arm64voxeltron-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.