index
Prefer a visual tour? See the TunaOS overview โ landing page.
TunaOSโ
A Collection of Cloud-Native Enterprise Linux OS Imagesโ
Bootc-based desktop Linux images built on AlmaLinux, CentOS Stream, and Fedora
๐ About TunaOSโ
TunaOS is a curated collection of bootc-based desktop operating systems built on modern container technology. The goal is to bring a modern desktop experience to Enterprise Linux โ stable, immutable, and up-to-date. Inspired by Bluefin and the Universal Blue community.
Featuresโ
- Modern Desktops: GNOME, KDE Plasma, COSMIC, and Niri โ your choice, on Enterprise Linux
- Latest GNOME: Don't get stuck on a 3-year-old GNOME. We backport the latest desktop features to the Enterprise Desktop
- 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 Option: Hardware Enablement kernel for newer hardware support
- NVIDIA Option: NVIDIA drivers and CUDA for graphics and AI workflows
๐ Imagesโ
Desktopsโ
Each variant ships multiple desktop environments:
| Tag suffix | Desktop |
|---|---|
gnome | GNOME (stable) |
gnome50 | GNOME 50 (latest) |
kde | KDE Plasma |
cosmic | COSMIC Desktop |
niri | Niri (tiling Wayland compositor) |
Hardware Variantsโ
Append to any desktop tag:
| Suffix | Description |
|---|---|
| (none) | Standard build |
-hwe | Hardware Enablement โ newer kernel stack |
-nvidia | NVIDIA drivers + CUDA |
-nvidia-hwe | NVIDIA on HWE kernel |
Example: ghcr.io/tuna-os/yellowfin:gnome-hwe, ghcr.io/tuna-os/albacore:kde-nvidia
๐ Yellowfin (AlmaLinux Kitten 10)โ
Base: AlmaLinux Kitten 10 โ the closest to upstream CentOS Stream
Platforms: x86_64, x86_64/v2 (pre-2013 CPUs), ARM64
ghcr.io/tuna-os/yellowfin:gnome
ghcr.io/tuna-os/yellowfin:gnome-hwe
ghcr.io/tuna-os/yellowfin:kde
ghcr.io/tuna-os/yellowfin:niri
ghcr.io/tuna-os/yellowfin:cosmic
- โจ x86_64/v2 microarchitecture support
- ๐ฅ๏ธ SPICE support for qemu/libvirt virtualization
- ๐ Compatible with upstream โ Kitten tracks CentOS Stream
๐ Albacore (AlmaLinux 10)โ
Base: AlmaLinux 10 โ stable, RHEL-compatible
Platforms: x86_64, x86_64/v2, ARM64
ghcr.io/tuna-os/albacore:gnome
ghcr.io/tuna-os/albacore:gnome-hwe
ghcr.io/tuna-os/albacore:kde
ghcr.io/tuna-os/albacore:niri
ghcr.io/tuna-os/albacore:cosmic
- โจ x86_64/v2 microarchitecture support
- ๐ฅ๏ธ SPICE support for qemu/libvirt virtualization
- ๐ข Enterprise stability โ follows RHEL lifecycle
๐ฃ Skipjack (CentOS Stream 10)โ
Base: CentOS Stream 10 โ the upstream of RHEL
Platforms: x86_64, ARM64
ghcr.io/tuna-os/skipjack:gnome
ghcr.io/tuna-os/skipjack:kde
ghcr.io/tuna-os/skipjack:niri
ghcr.io/tuna-os/skipjack:cosmic
[!NOTE] Bonito is still a work in progress and may not be fully functional
๐ฃ Bonito (Fedora 44)โ
Base: Fedora 44 โ cutting-edge Fedora on bootc
Platforms: x86_64, ARM64
ghcr.io/tuna-os/bonito:gnome
ghcr.io/tuna-os/bonito:kde
ghcr.io/tuna-os/bonito:niri
ghcr.io/tuna-os/bonito:cosmic
๐ Redfin (RHEL 10) โ Local-Build Onlyโ
Base: Red Hat Enterprise Linux 10 โ fully supported, subscription-based
Platforms: x86_64, ARM64
[!IMPORTANT] Due to the RHEL EULA, Redfin images cannot be publicly distributed. This variant is local-build only. For a freely redistributable RHEL-compatible alternative, use Albacore (AlmaLinux 10).
See docs/rhel-setup.md for prerequisites, authentication, and build instructions.
just redfin base
๐ System Requirementsโ
| Component | Minimum | Recommended |
|---|---|---|
| CPU | x86_64, ARM64 | x86_64, ARM64 |
| RAM | 4 GB | 8 GB+ |
| Storage | 20 GB | 50 GB+ |
๐ ๏ธ Installationโ
Use a pre-built ISOโ
ISOs are published every two weeks for gnome and gnome-hwe flavors of Yellowfin and Albacore:
| Variant | GNOME | GNOME (HWE) |
|---|---|---|
| Albacore | albacore-gnome-latest.iso | albacore-gnome-hwe-latest.iso |
| Yellowfin | yellowfin-gnome-latest.iso | yellowfin-gnome-hwe-latest.iso |
Build your own ISO or VM imageโ
Use tacklebox to build ISOs:
# ISO (requires root)
sudo tacklebox build --iso tunaos-yellowfin-gnome.iso \
--bootable-environment-image ghcr.io/tuna-os/yellowfin:gnome \
--bootable-environment-desktop gnome \
--output-base .build/iso
Or use the included helper script:
sudo ./scripts/build-iso-tacklebox.sh yellowfin gnome ghcr gnome
For QCOW2 VM images, use bootc directly:
# QCOW2 (VM image)
sudo bootc image build-to-qcow2 \
--output-format qcow2 \
ghcr.io/tuna-os/yellowfin:gnome
Switch an existing systemโ
If you're already running a compatible bootc system:
sudo bootc switch ghcr.io/tuna-os/yellowfin:gnome
๐ Container Registry Authenticationโ
Images are published on GitHub Container Registry (GHCR). To pull images with bootc or podman:
# Authenticate to GHCR (requires a GitHub personal access token with read:packages scope)
echo "$GITHUB_TOKEN" | podman login ghcr.io -u YOUR_USERNAME --password-stdin
# Or use the GitHub CLI
gh auth token | podman login ghcr.io -u YOUR_USERNAME --password-stdin
See GitHub Container Registry docs for more details.
๐งช Current Statusโ
Note: These images are in active development. Yellowfin and Albacore are the most mature variants. Bonito (Fedora) still needs work.
Contributingโ
Contributions welcome! See CONTRIBUTING.md for:
- Development environment setup
- Build workflow and pre-commit checklist
- Pull request guidelines
- Architecture overview
๐ค Community & Supportโ
- ๐ Report Issues: GitHub Issues
- [m] Chat: #tunaos:reilly.asia
Related Communities:
- ๐ฎ Discord: Universal Blue Community
- ๐ฌ AlmaLinux Atomic SIG: AlmaLinux Atomic SIG
๐ Documentationโ
Project Docsโ
- Contributor Guide โ how to set up, build, and contribute
- Agent Guide โ complete architecture and contributor reference
- Build Pipeline โ CI/CD workflow overview
- Testing Guide โ ISO end-to-end test harness
- Improvement Plan โ roadmap and development progress
- Redfin Setup โ RHEL 10 local-build instructions
- Developer Docs โ build and contribution guide
Policies & Planningโ
- Roadmap โ project direction and feature status
- Versioning โ tag scheme and stability tiers
- Migration Guide โ switching from other distros
- Security Policy โ vulnerability reporting and supported versions
- Code of Conduct โ community standards
Community & Governanceโ
- Community โ contribution ladder, metrics, communication
- Maintainers โ maintainer playbook and bus factor plan
TunaOS ecosystemโ
The tools that build, install, and extend these images โ see them all on the Projects page:
- Tacklebox โ builds the ISOs and multi-boot media from TunaOS images
- COPR Builds โ backports GNOME 50 to Enterprise Linux (the
gnome50image) - Tromsรธ & XFCE Linux โ BuildStream-from-source KDE and XFCE images
- Tavern & bluefin-cli โ desktop and shell tooling
External Resourcesโ
Made by James in his free time
Powered by Bootc

Inspired by Bluefin and the Universal Blue Community
Licensed under Apache 2.0