Skip to main content

ISO Testing

Here is a short runbook for the Bluefin installation process. Read the entirety of this documentation in order to ensure survival. (In case of a raptor attack).

Things to Test For

  • Installation experience
  • Secure Boot
  • First run experience, check a few applications and the Bazaar app store
  • Bare metal if possible but not required
  • If you've got the time, go through the docs and run through the new user experience step by step. These bugs are highly prized, so if you find one, file it!
  • File issues in the @projectbluefin/iso repository

Bluefin LTS

The long-term support experience. 📖 Read the documentation to learn about features and differences. HWE images include updated kernels — recommended for newer devices.

bluefin-lts-x86_64.iso
AMDAMDIntelIntel
bluefin-lts-aarch64.iso
ARMARM (aarch64)
bluefin-lts-hwe-x86_64.iso
AMDAMDIntelIntel (HWE)
bluefin-lts-hwe-aarch64.iso
ARMARM (HWE)
bluefin-lts-hwe-testing-x86_64.iso
AMDAMDIntelIntel
bluefin-lts-hwe-testing-aarch64.iso
ARMARM (aarch64)
bluefin-gdx-lts-x86_64.iso
NVIDIANvidia
bluefin-gdx-lts-aarch64.iso
ARMARM (aarch64)

Verifying Downloads with Checksums

Checksums allow you to verify that your download completed successfully and wasn't corrupted or tampered with. After downloading an ISO, you can compare its checksum to the official checksum file to ensure integrity. While optional, verification is recommended for important installations.

How to verify checksums using sha256sum

  1. Download both the ISO file and its corresponding CHECKSUM file

    • For example: bluefin-stable-x86_64.iso and bluefin-stable-x86_64.iso-CHECKSUM
  2. Generate the checksum of your downloaded ISO:

    sha256sum bluefin-stable-x86_64.iso
  3. Verify against the official checksum file:

    sha256sum -c bluefin-stable-x86_64.iso-CHECKSUM --ignore-missing
  4. Confirm the result: Look for OK in the output for your ISO file.

Example:

# Generate checksum of downloaded file
$ sha256sum bluefin-stable-x86_64.iso
a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456 bluefin-stable-x86_64.iso

# Verify against official checksum file
$ sha256sum -c bluefin-stable-x86_64.iso-CHECKSUM --ignore-missing
bluefin-stable-x86_64.iso: OK

# 🦖 Rawr! Your download is verified