Razorfin

Razorfin is a custom Universal Blue image based on Bazzite that replaces KDE Plasma with the COSMIC desktop environment. It combines Bazzite's gaming optimizations and hardware support with System76's next-generation Rust-based desktop.

The DX variants do not use Bazzite's bazzite-dx images. Those are built on bazzite-deck (the handheld/Game Mode image), so Razorfin layers its own developer tools (libvirt/QEMU, Docker CE, eBPF tooling, Sunshine, and more) on top of the desktop bazzite and bazzite-nvidia-open bases instead. See build_files/04-dx.sh.

Images are built once and promoted between channels by re-tagging, so each channel ships the exact same image digest that was validated in the tier below it.

Each promotion also creates a date-stamped tag (e.g., stable.20260208) that can be used for pinning or rollback.

# Base variant (AMD/Intel) — stable channel (recommended)
sudo bootc switch --enforce-container-sigpolicy ghcr.io/razorfinos-org/razorfin:stable

# DX variant
sudo bootc switch --enforce-container-sigpolicy ghcr.io/razorfinos-org/razorfin-dx:stable

# NVIDIA Open variant
sudo bootc switch --enforce-container-sigpolicy ghcr.io/razorfinos-org/razorfin-nvidia-open:stable

# DX + NVIDIA Open variant
sudo bootc switch --enforce-container-sigpolicy ghcr.io/razorfinos-org/razorfin-dx-nvidia-open:stable

To track a different channel, replace :stable with :latest or :testing.

ISOs are built monthly from the stable channel. Each build is published on the Releases page with SHA256 checksums and the exact image digests it was built from. The ISOs themselves are hosted at download.razorfin.org — only the newest stable build is kept.

Verify your download:

curl -LO https://download.razorfin.org/razorfin-live-amd64.iso
curl -LO https://download.razorfin.org/razorfin-live-amd64.iso.sha256
sha256sum -c razorfin-live-amd64.iso.sha256

All images are signed with Cosign. The public key is included in this repository as cosign.pub.

cosign verify --key cosign.pub ghcr.io/razorfinos-org/razorfin:stable

Switch your system to a different release channel at any time:

# Move to the stable channel
sudo bootc switch --enforce-container-sigpolicy ghcr.io/razorfinos-org/razorfin:stable

# Or pin to a specific date-stamped image
sudo bootc switch --enforce-container-sigpolicy ghcr.io/razorfinos-org/razorfin:stable.20260208

systemctl reboot

If an update causes issues, you can roll back to the previous deployment without re-downloading anything:

sudo bootc rollback
systemctl reboot

Or switch to a known-good date-stamped image:

sudo bootc switch --enforce-container-sigpolicy ghcr.io/razorfinos-org/razorfin:stable.20260201
systemctl reboot

Razorfin uses Just for build automation (available by default on all Universal Blue images).

just build                  # Base variant
just build-dx               # DX variant
just build-nvidia-open      # NVIDIA Open variant
just build-dx-nvidia-open   # DX + NVIDIA Open variant

just build-iso              # Base variant
just build-iso-nvidia-open  # NVIDIA Open variant

just build-qcow2            # Build base QCOW2
just run-vm-qcow2           # Build and run in a VM

Run just with no arguments to see all available recipes.

See the release runbook for details on the CI/CD pipeline, emergency hotfix procedures, and rollback operations.

• razorfin.org — project website and downloads
• Universal Blue Forums
• Universal Blue Discord
• COSMIC Desktop
• Bazzite

Apache-2.0