Skip to main content

index

![]

TunaOS​

Cloud-native, immutable desktop Linux images​

One desktop experience with bootc across Enterprise Linux and community distributions


License GitHub Stars Issues External adoption evidence Discussions

🎃 Hacktoberfest 2026: Start with the org-wide good first issues. See the ecosystem guide for a map of repositories, mentorship, Q&A, and office hours.

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 an alternative distribution for a faster release cadence. Both choices use the same image-based management model.

Visit tunaos.org or read the User Guide.

Make your first contribution · Meet the contributors · Contributor roadmap

  • 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 a brew command 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​

VariantBase OSRegistry PathDesktopsArchitectures
🐠 YellowfinAlmaLinux Kitten 10ghcr.io/tuna-os/yellowfinGNOME (x86_64 only, see note), KDE, COSMIC, Niri, Tuna (x86_64 only), XFCEx86_64, x86_64/v2, arm64
🐟 AlbacoreAlmaLinux 10 (RHEL 10)ghcr.io/tuna-os/albacoreGNOME (x86_64 only, see note), KDE, COSMIC, Niri, Tuna (x86_64 only), XFCEx86_64, x86_64/v2, arm64
🍣 SkipjackCentOS Stream 10ghcr.io/tuna-os/skipjackGNOME (x86_64 only, see note), KDE, COSMIC, Niri, Tuna (x86_64 only), XFCEx86_64, arm64
🎣 BonitoFedora 44ghcr.io/tuna-os/bonitoGNOME, KDE, COSMIC, Niri, Tuna (x86_64 only), XFCEx86_64, arm64
🐦 HummingbirdFedora Hummingbird (experimental)ghcr.io/tuna-os/hummingbirdBase, GNOME, COSMIC, Tunax86_64 (see note)
🎏 WahooFedora ELN — EL11 preview (experimental, no codecs)ghcr.io/tuna-os/wahooBase, GNOME, KDE, COSMIC, Tuna (x86_64 only)x86_64, arm64
🔒 RedfinRed Hat Enterprise Linux 10Local-Build OnlyGNOME, KDE, COSMIC, Niri, XFCEx86_64, arm64
🪸 GrouperUbuntu 26.04ghcr.io/tuna-os/grouperGNOME, KDE, COSMIC, Tuna, XFCEx86_64
🤖 GurnardUbuntu 24.04 (Noble Numbat, experimental)ghcr.io/tuna-os/gurnardBase, Pantheon, Tunax86_64, arm64
🚀 MarlinArch Linux (Rolling)ghcr.io/tuna-os/marlinGNOME, KDE, COSMIC, Niri, Tuna, XFCEx86_64
🐡 FlounderDebian 13 (Trixie)ghcr.io/tuna-os/flounderKDE, Tuna, XFCEx86_64
Tromsøfreedesktop-sdk (BuildStream), built in tuna-os/tromsoghcr.io/tuna-os/tromsoKDEx86_64
XFCE Linux (Brussels)freedesktop-sdk (BuildStream), built in tuna-os/xfce-linuxghcr.io/tuna-os/xfce-linuxXFCEx86_64
AthensGNOME OS OCI runtime (BuildStream)Local-only: oci/athens.bstPantheonNot published
⛵ SailfinopenSUSE Tumbleweedghcr.io/tuna-os/sailfinGNOME, KDE, COSMIC, Niri, Tuna, XFCEx86_64
🌈 GuppyGentoo Linuxghcr.io/tuna-os/guppyGNOME, KDE, Tuna, XFCEx86_64
🏔️ Tromsøfreedesktop-sdk (BuildStream), built in tuna-os/tromsoghcr.io/tuna-os/tromsoKDEx86_64
🐭 XFCE Linuxfreedesktop-sdk (BuildStream), built in tuna-os/xfce-linuxghcr.io/tuna-os/xfce-linuxXFCEx86_64

GNOME on the EL10 variants comes from the tunaOS GNOME 50 package tier. GitHub Actions builds this tier without COPR. The tier supports only x86_64 today, so the gnome and gnome-hwe images have only x86_64 support. The gnome-asahi image is off until the tier adds aarch64 (tunaos-packages#673). Every GNOME image uses GNOME 50 or newer. The project does not promote older versions.

Hummingbird is x86_64 only. This includes its base. The aarch64 package snapshot has no xfsprogs, and the base stage needs it. No hummingbird arm64 image builds today. The architecture is absent, not thinner. See docs/HUMMINGBIRD.md.

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​

The configured matrix now has 155 image cells. Fifteen of them are Tuna Desktop (formerly Roost) cells for amd64: marlin:tuna, yellowfin:tuna, albacore:tuna, skipjack:tuna, wahoo:tuna, bonito:tuna, bonito:tuna-rawhide, hummingbird:tuna, grouper:tuna, stingray:tuna, gurnard:tuna, guppy:tuna, flounder:tuna, flounder:tuna-sid and sailfin:tuna. The tuna_rollout record in tunaos.toml gives each other variant its reason to stay unsupported. The guppy:gnome cell is back (2026-10-07, #2450). Tuna Desktop adds no ISO or LUKS cells.

Five cells are stingray (base, gnome, kde, xfce, tuna), the dispatch-only variant for Ubuntu interim releases. The former marlin:roost tags get no more updates; existing installs must follow the explicit switch and recovery procedure. The status snapshot below is from before those additions and does not prove image publication or a successful boot.

guppy:tuna pins the signed native package, which starts only GDM. Promotion stays on hold. The published image must first pass qualification.

Each cell reports the newest conclusive main-branch run that asserted it, so a flavor-filtered rebuild does not blank the cells it never scheduled. This table omits cancelled runs. Latest run names the variant's newest conclusive run. A green cell has a successful promotion to the published tag. Failed means that a job ran and failed. Not reached means that no recent run asserted the cell, usually because an earlier stage stopped it.

VariantGreen image cellsLatest runFailingNot reached
🐠 yellowfin19/19❌ 2026-10-22——
🐟 albacore19/19✅ 2026-10-22——
🍣 skipjack17/17❌ 2026-10-22——
🎏 wahoo4/5❌ 2026-10-16tuna—
🎣 bonito17/17✅ 2026-10-21——
🐦 hummingbird1/3❌ 2026-10-15gnomecosmic
⛵ sailfin7/7✅ 2026-10-22——
🌈 guppy3/4❌ 2026-10-23—gnome
🐉 bonito-rawhide14/15❌ 2026-10-22—gnome
🤖 gurnard2/2✅ 2026-10-23——
🪸 grouper8/8✅ 2026-10-22——
🚀 marlin17/17❌ 2026-10-22——
🐡 flounder6/6✅ 2026-10-23——
☢️ flounder-sid5/8❌ 2026-10-23—gnome-nvidia,kde-nvidia,xfce-nvidia

BuildStream image family. These TunaOS products use independent BuildStream projects and release pipelines. They are part of this image matrix, but remain separate from the distro × desktop cell counts and their green criteria. Published OCI references show the latest conclusive main-branch build. Athens is experimental and local-only: CI checks its graph, but there is no published image build.

BrandImage or targetProjectDesktopAvailabilityLatest main build
ghcr.io/tuna-os/tromsotromsoKDEAlpha · GHCR OCI reference❌ 2026-10-31
ghcr.io/tuna-os/xfce-linuxxfce-linuxXFCEAlpha · GHCR OCI reference✅ 2026-10-31
oci/athens.bst (local-only)athensPantheonExperimental · local-only; no public image— (graph checks only; no image build)

Built 139/147 · composite green 120/147 (94% built) — The remainder has 2 failures and 6 never reached (stale: 5); no job asserted the latter. We show the two values separately. A cell with no job has no test, but it can still work.

Factory health: 124/147 cells green

Install-tested: 110/110 · Lifecycle-tested: 41/52 · Never tested: 33

Known regressions: 11 blocking, 86 advisory

Last full sweep: 46 days ago (2026-09-01) The score for composite green uses published cells, per docs/MATRIX-STATUS.md. .github/green-criteria.yml provides the score. Today, these criteria prevent publication: boots, builds, desktop, no_silent_omissions, parity. A cell must satisfy each criterion.

Skipped cells and cells with no test do not count as green. The full per-axis board is docs/MATRIX-STATUS.md. This snapshot of CI shows one point in time. It does not promise a support tier.

Get started​

For local media builds, signature and SBOM checks, registry authentication, and pull help, read docs/INSTALL.md.

Contribute compute — no code needed​

Donate time with your AI CLI.

Your machine runs one task at a time using your signed-in AI coding CLI. The relay alternates between eligible School (OS) and Reef (apps) hives after each task. If one hive has no work, the other can continue.

The guide covers prerequisites, verified just setup, credentials, provider costs, and how to stop with Ctrl+C. Your subscription quota or API charges apply. Never post account credentials or API keys in issues or pull requests.

Contributing​

Contribute through Hive to donate time with your AI CLI.

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​

Related communities: Universal Blue Discord · AlmaLinux Atomic SIG

Documentation​

Start here:

  • User Guide — image choice, installation, updates, rollback, apps, and encryption
  • Developer Guide — the complete pipeline with architecture diagrams
  • Installation — media builds, verification, and registry access
  • Hardware Support — requirements and ARM laptop status
  • Matrix Status — quality status for each variant×desktop cell
  • Roadmap — project direction and feature status
  • Vision — project philosophy

To customize a fork, start at Customize a fork. The full index of every guide, policy, and project plan is at docs/README.md.


Tuna_OS_Logo

Made by James in his free time

Powered by Bootc

Bootc_Logo

Inspired by Bluefin and the Universal Blue Community

Licensed under Apache 2.0