❓ Frequently Asked Questions
General
What is TunaOS?
TunaOS is a collection of bootc-based, immutable desktop operating system images built on Enterprise Linux (AlmaLinux, CentOS Stream, Fedora). It brings modern desktops (GNOME, KDE, COSMIC, XFCE, Niri) to a stable, enterprise-grade foundation.
Is TunaOS a Linux distribution?
Yes — but not in the traditional sense. TunaOS images are bootable OCI containers, not traditional packages. You pull images and switch between them like containers to receive a full desktop experience.
Is TunaOS free?
Yes. Apache 2.0 licenses TunaOS as open source.
Installation
How do I install TunaOS?
Two ways:
- Fresh install — Download an ISO from tunaos.org/download and write it to USB
- Switch from an existing bootc system —
sudo bootc switch ghcr.io/tuna-os/yellowfin:gnome && sudo reboot
Can I dual-boot TunaOS?
TunaOS uses bootc which manages the bootloader. Dual-boot is possible but not the primary use case. For multi-OS on one machine, use Tacklebox to create a multi-boot USB.
Which variant should I choose?
| Need | Variant | Base |
|---|---|---|
| Latest EL | Yellowfin | AlmaLinux Kitten 10 |
| Stable EL | Albacore | AlmaLinux 10 |
| Upstream EL | Skipjack | CentOS Stream 10 |
| Fedora | Bonito | Fedora 44 |
| Ubuntu + Pantheon | Gurnard | Ubuntu 24.04 LTS |
| Ubuntu | Grouper | Ubuntu 26.04 |
| Arch (Rolling) | Marlin | Arch Linux |
| Debian | Flounder | Debian 13 (Trixie) |
| openSUSE | Sailfin | openSUSE Tumbleweed |
| Gentoo | Guppy | Gentoo Linux |
| GNOME | Any :gnome tag | — |
| KDE Plasma | Any :kde or Tromsø | — |
| COSMIC | Any :cosmic tag | — |
| Pantheon | Any :pantheon tag (Gurnard) | — |
| Lightweight | XFCE Linux | freedesktop-sdk |
| Tiling WM | Any :niri tag | — |
| RHEL (local build) | Redfin | RHEL 10 |
The full, current variant matrix (including experimental variants such as Hummingbird, Bonito Rawhide, and Flounder Sid) lives on the variant pages.
Variants
What's the difference between Yellowfin, Albacore, Skipjack, and Bonito?
They differ by base OS:
- Yellowfin — AlmaLinux Kitten 10 (closest to upstream CentOS Stream)
- Albacore — AlmaLinux 10 (stable Enterprise Linux)
- Skipjack — CentOS Stream 10 (RHEL upstream)
- Bonito — Fedora 44 (latest packages, ARM64 support)
All four support the same desktop environments and hardware variants. Desktop availability differs across the wider variant family, though. Gurnard ships Base + Pantheon (elementary OS's desktop). Grouper, Flounder, and Marlin add XFCE to the core GNOME/KDE/COSMIC/Niri set. See the variant page for the exact desktop × architecture matrix.
What does -hwe and -nvidia mean?
| Suffix | Meaning |
|---|---|
-hwe | Hardware Enablement — newer kernel for newer hardware |
-nvidia | NVIDIA drivers + CUDA for GPU/AI workloads |
-nvidia-hwe | NVIDIA/CUDA on the HWE kernel |
Example: ghcr.io/tuna-os/yellowfin:gnome-nvidia-hwe
The
-nvidiasuffix replaced the legacy-gdxsuffix —-gdxtags no longer exist.
Desktop Environments
Which desktop environment is best for my hardware?
| Hardware | Recommended | RAM usage |
|---|---|---|
| Modern (16GB+) | GNOME or KDE | ~1-1.2 GB |
| Mid-range (8GB) | COSMIC or KDE | ~0.8-1 GB |
| Older/light (4GB) | XFCE | ~600 MB |
| Minimal/VM | XFCE or Niri | ~400-600 MB |
Can I switch desktop environments without a fresh installation?
Yes! Use bootc switch:
# From GNOME to COSMIC
sudo bootc switch ghcr.io/tuna-os/yellowfin:cosmic
sudo systemctl reboot
Package Management
Can I use apt/dnf on TunaOS?
TunaOS images are immutable — /usr is read-only at runtime. However:
- Homebrew is pre-installed for user-space tools
- Flatpak is pre-enabled for GUI apps
- Toolbox/Distrobox provides a mutable container for
dnf/apt
# Use Toolbox for traditional package management
toolbox enter
sudo dnf install htop
How do I update TunaOS?
sudo bootc upgrade && sudo systemctl reboot
This pulls the latest image and reboots into it. Rollback is one command: sudo bootc rollback.
Community
How can I contribute?
See CONTRIBUTING.md. Good first steps:
- Try a TunaOS variant and report issues
- Improve documentation
- Look for
good-first-issuelabels in TunaOS repos - Join the Matrix chat
Where do I report bugs?
Open an issue on the relevant GitHub repository. For general issues, use tuna-os/tunaOS.
Technical
What is bootc?
bootc is a CNCF Sandbox project for bootable container images. Instead of package-based OS updates, the entire OS is a container image that you pull, switch to, and reboot. Learn more in the Bootc Guide.
How are images built?
TunaOS images are built in GitHub Actions using Containerfiles. See Build Guide and CI/CD.
Does TunaOS support Secure Boot?
Yes. The base OS provides a standard shim mechanism that enables UEFI Secure Boot.