index
![]
TunaOSโ
Cloud-native, immutable desktop Linux imagesโ
One bootc-native desktop experience across Enterprise Linux and community distributions
About TunaOSโ
TunaOS builds bootc-based desktop operating systems with atomic updates and straightforward rollbacks. Choose an Enterprise Linux base for long-term stability or a community distribution for a faster release cadence, while keeping the same image-based management model.
Visit tunaos.org or read the launch announcement.
- Modern Desktops: GNOME, KDE Plasma, COSMIC, Niri, and XFCE โ equal first-class options across distribution bases
- Up-to-Date Desktop Stack: Fresh desktop features and updates backported to Enterprise and community bases
- Homebrew: Baked into the image โ all your CLI apps and fonts are just a
brewcommand away - Flathub by Default: Full Flathub access out of the box โ get any Flatpak available on the net
- HWE and NVIDIA Options: Hardware Enablement kernels and NVIDIA drivers + CUDA as image tags
Choose your imageโ
| Variant | Base OS | Registry Path | Desktops | Architectures |
|---|---|---|---|---|
| ๐ Yellowfin | AlmaLinux Kitten 10 | ghcr.io/tuna-os/yellowfin | GNOME, KDE, COSMIC, Niri | x86_64, x86_64/v2, arm64 |
| ๐ Albacore | AlmaLinux 10 (RHEL 10) | ghcr.io/tuna-os/albacore | GNOME, KDE, COSMIC, Niri | x86_64, x86_64/v2, arm64 |
| ๐ฃ Skipjack | CentOS Stream 10 | ghcr.io/tuna-os/skipjack | GNOME, KDE, COSMIC, Niri | x86_64, arm64 |
| ๐ฃ Bonito | Fedora 44 | ghcr.io/tuna-os/bonito | GNOME, KDE, COSMIC, Niri | x86_64, arm64 |
| ๐ฆ Hummingbird | Fedora Hummingbird (experimental) | ghcr.io/tuna-os/hummingbird | Base, GNOME, KDE, COSMIC, Niri | x86_64, arm64 |
| ๐ Redfin | Red Hat Enterprise Linux 10 | Local-Build Only | GNOME, KDE, COSMIC, Niri, XFCE | x86_64, arm64 |
| ๐ Grouper | Ubuntu 26.04 | ghcr.io/tuna-os/grouper | GNOME, KDE, Niri, XFCE | x86_64 |
| ๐ Gurnard | Ubuntu 24.04 (Noble Numbat, experimental) | ghcr.io/tuna-os/gurnard | Base, Pantheon | x86_64, arm64 |
| ๐ Marlin | Arch Linux (Rolling) | ghcr.io/tuna-os/marlin | GNOME, KDE, COSMIC, Niri, XFCE | x86_64 |
| ๐ก Flounder | Debian 13 (Trixie) | ghcr.io/tuna-os/flounder | GNOME, KDE, COSMIC, Niri, XFCE | x86_64 |
| โข๏ธ Flounder Sid | Debian Sid (Unstable) | ghcr.io/tuna-os/flounder:*-sid | GNOME, KDE, COSMIC, Niri, XFCE | x86_64 |
| ๐ Bonito Rawhide | Fedora Rawhide | ghcr.io/tuna-os/bonito:*-rawhide | GNOME, KDE, COSMIC, Niri, XFCE | x86_64, arm64 |
| ๐ฆ Sailfin | openSUSE Tumbleweed | ghcr.io/tuna-os/sailfin | GNOME, KDE, Niri, XFCE | x86_64 |
| ๐ Guppy | Gentoo Linux | ghcr.io/tuna-os/guppy | GNOME, KDE | x86_64 |
Tags are <desktop>[-hardware] โ e.g. yellowfin:gnome-hwe,
albacore:kde-nvidia. Full tag reference: docs/IMAGE-TAGS.md.
Hardware requirements and ARM laptop status: docs/HARDWARE.md.
[!NOTE] Redfin (RHEL 10) is local-build only due to EULA restrictions. To build it locally, run
just build redfin <desktop>(see rhel-setup.md).
Live build matrixโ
Generated from the latest conclusive main-branch build for each variant (cancelled runs are skipped over). A cell is green when its image was successfully promoted to the published tag; failing means a job ran and failed; not reached means no job asserted the cell at all, usually because an earlier stage stopped it.
| Variant | Green image cells | Latest run | Failing | Not reached |
|---|---|---|---|---|
๐ yellowfin | 14/20 | โ 2026-08-18 | โ | base,gnome-nvidia,gnome-nvidia-hwe,cosmic-nvidia,kde-nvidia,niri-nvidia |
๐ albacore | 2/20 | โ 2026-08-17 | โ | base-hwe,gnome,cosmic,kde,niri,xfce,gnome-hwe,gnome-asahi,gnome-nvidia,gnome-nvidia-hwe,cosmic-hwe,cosmic-nvidia,kde-hwe,kde-nvidia,niri-hwe,niri-nvidia,xfce-hwe,xfce-nvidia |
๐ฃ skipjack | 10/18 | โ 2026-08-18 | โ | gnome,gnome-hwe,gnome-asahi,gnome-nvidia,gnome-nvidia-hwe,cosmic-nvidia,kde-nvidia,niri-nvidia |
๐ฃ bonito | 5/15 | โ 2026-08-18 | โ | base-nvidia,gnome,niri,gnome-hwe,gnome-asahi,gnome-nvidia,cosmic-nvidia,kde-nvidia,niri-nvidia,xfce-nvidia |
๐ฆ hummingbird | 1/5 | โ 2026-08-18 | โ | gnome,kde,niri,cosmic |
๐ฆ sailfin | 6/7 | โ 2026-08-18 | โ | gnome-asahi |
๐ guppy | 3/4 | โ 2026-08-18 | โ | gnome |
๐ bonito-rawhide | 8/14 | โ 2026-08-18 | โ | base-nvidia,gnome,cosmic,kde,niri,xfce |
๐ gurnard | 2/2 | โ 2026-08-18 | โ | โ |
๐ grouper | 2/7 | โ 2026-08-17 | โ | gnome,gnome-zfs,kde,cosmic,xfce |
๐ marlin | 16/16 | โ 2026-08-18 | โ | โ |
๐ก flounder | 1/7 | โ 2026-08-17 | โ | gnome,kde,xfce,gnome-nvidia,kde-nvidia,xfce-nvidia |
โข๏ธ flounder-sid | 5/7 | โ 2026-08-18 | โ | gnome,xfce |
Built 75/142 ยท composite green 75/142 (52%) โ of the remainder, 0 failing and 67 never reached (no job asserted them). The two are reported separately on purpose: a never-reached cell is untested, not broken. Composite green is scored against .github/green-criteria.yml (blocking today: builds + boots โ a cell must promote AND pass its boot Gate; the full per-axis board is docs/MATRIX-STATUS.md). This is a point-in-time CI snapshot, not a support-tier promise.
Get startedโ
-
Install from an ISO: ๐ฆ tunaos.org/download
-
Build your own ISO in the browser: ๐ ๏ธ tunaos.org/iso-builder
-
Switch an existing bootc system:
sudo bootc switch ghcr.io/tuna-os/yellowfin:gnome
Building media locally, verifying signatures and SBOMs, registry authentication, and pull troubleshooting: docs/INSTALL.md.
Contributingโ
Contributions welcome! See CONTRIBUTING.md for development
environment setup, the build workflow and pre-commit checklist, pull request
guidelines, and an architecture overview.
Community and supportโ
- ๐ Report Issues: GitHub Issues
- [m] Chat: #tunaos:reilly.asia
- ๐ฎ Discord: TunaOS
Related communities: Universal Blue Discord ยท AlmaLinux Atomic SIG
Documentationโ
Start here:
- User Guide โ choosing an image, installing, updating, rolling back, apps, encryption
- Developer Guide โ the whole pipeline and its plumbing, with diagrams
- Installation โ building media, verification, registry access
- Hardware Support โ requirements and ARM laptop status
- Matrix Status โ which variantรdesktop cells are verified, per quality axis
- Roadmap โ project direction and feature status
- Vision โ project philosophy
The full index โ every guide, policy, and planning doc โ is at docs/README.md.
Made by James in his free time
Powered by Bootc

This repository and many of the tuna-os repos are developed and maintained with Hive, an AI-driven development platform orchestrated via KubeStellar.
Inspired by Bluefin and the Universal Blue Community
Licensed under Apache 2.0