tunaOS

(★ 55)

Bringing a modern cloud-native experience to the Enterprise Linux Desktop

File Explorer

ZIP Download

- - pin.yml
- - aurora-port.md
  - bluefin-lts-port.md
  - zirconium-port.md
- - check-el10-packages.py
  - cosign-retry.sh
  - fire-copilot-batch.py
  - update-build-status.sh
  - write-gemini-task.py
- - arm64-ulimit-probe.yml
  - asahi-hw-nightly-one.yml
  - asahi-hw-nightly.yml
  - bootc-lifecycle.yml
  - build-albacore.yml
  - build-archlinuxarm-base.yml
  - build-bonito-rawhide.yml
  - build-bonito.yml
  - build-flavor.yml
  - build-flounder-sid.yml
  - build-flounder.yml
  - build-grouper.yml
  - build-guppy.yml
  - build-gurnard.yml
  - build-hummingbird.yml
  - build-marlin.yml
  - build-sailfin.yml
  - build-skipjack.yml
  - build-toolchain.yml
  - build-variant.yml
  - build-wahoo.yml
  - build-yellowfin.yml
  - catalog-facts.yml
  - check-base-image-pins.yml
  - content-filter.yaml
  - daily-verify.yml
  - desktop-contract-sweep.yml
  - frontend-parity.yml
  - gdm-paint-benchmark.yml
  - generate-changelog-release.yml
  - ghcr-partial-pull-check.yml
  - installer-screenshots.yml
  - installer-smoke.yml
  - iso-builder-parity.yml
  - iso-e2e.yml
  - just-fix.yml
  - lint.yml
  - live-initramfs.yml
  - live-iso-bootc.yml
  - live-overlay.yml
  - luks-e2e.yml
  - matrix-status.yml
  - package-parity.yml
  - publish-iso-groups.yml
  - publish-isos.yml
  - rerun-infra-failures.yml
  - rerun-startup-failures.yml
  - reusable-build-artifacts.yml
  - reusable-build-image.yml
  - scorecard.yml
  - snapshot-upstreams.yml
  - test.yml
  - update-build-status.yml
  - validate-renovate.yaml
  - verify-asahi-one.yml
  - verify-asahi.yml
  - watch-aurora.yml
  - watch-bluefin-lts.yml
  - watch-upstream.yml
  - watch-zirconium.yml
  - weekly-boot-report.yml
  - weekly-desktop-screenshots.yml
  - weekly-qcow2-screenshots.yml
- actionlint.yaml
- build-config.yml
- changelogs.py
- CODEOWNERS
- copilot-instructions.md
- FUNDING.yml
- green-criteria.yml
- pull.yml
- runs-on.yml
- semantic.yaml
- - .snapshot.json
  - Containerfile.in
  - image-versions.yml
  - Justfile
- - .snapshot.json
  - Containerfile
  - Justfile
- - .snapshot.json
  - iso-nvidia.toml
  - iso.toml
  - Justfile
  - mkosi.bump
  - mkosi.conf
  - mkosi.postinst.chroot
  - mkosi.prepare.chroot
- - install-bootbin-sync.sh
- - build-libostree.sh
  - containers-policy.sh
  - dracut-config.sh
  - finalize.sh
  - install-bootc.sh
  - mount-system.sh
  - ostree-layout.sh
- - e2e-runtime-checks.sh
  - package-miss-allowlist.txt
  - verify-base-contract.sh
  - verify-branding-kde.sh
  - verify-branding-niri.sh
  - verify-branding.sh
  - verify-desktop-experience.sh
  - verify-nvidia-arch.sh
  - verify-nvidia-debian.sh
  - verify-nvidia.sh
  - verify-package-wishlist.sh
- - configure-desktop-runtime.sh
  - flatpak-preinstall.sh
  - gentoo-binhost-version-lock.sh
  - gnome-extensions.sh
  - greetd-gtkgreet.sh
  - install-desktop.sh
  - kcm-ublue.sh
  - kde-set-look-and-feel.sh
  - niri.sh
  - tuna-flatpak-remote.sh
  - xfce-greeter.sh
  - xfce.sh
  - xfwm4-theme.sh
  - zfs.sh
- - asahi.sh
  - cachyos.sh
  - hwe.sh
  - nvidia.sh
  - t2.sh
- - image-info-set
- 00-copy-files.sh
- 01-workarounds.sh
- 10-base-packages.sh
- 20-packages.sh
- 26-packages-post.sh
- 40-services.sh
- 90-image-info.sh
- 91-arch-customizations.sh
- 92-variant-customizations.sh
- 99-cleanup.sh
- apply-custom.sh
- install-remora.sh
- install-zirconium.sh
- lib.sh
- README.md
- ubuntu-kernel.sh
- build.post.sh
- build.pre.sh
- image.yaml
- packages.yaml
- - 0001-gdx-to-nvidia-rename.md
  - 0002-browser-iso-builder.md
  - 0003-mkosi-co-build-poc.md
  - 0004-rfc-lifecycle.md
  - 0005-flavor-equality.md
  - 0006-date-based-versioning.md
  - 0007-registry-mirror-support.md
  - 0008-shell-python-boundary.md
- - domain.md
  - issue-tracker.md
  - triage-labels.md
- - reusable-build-image-decomposition.md
- ADOPTION-CALL.md
- ADOPTION-OUTREACH-STATUS.md
- AGENT_GUIDE.md
- ALMALINUX-COMMUNITY-INTRO.md
- ASAHI-EL10-OBS-PROJECT.md
- ASAHI-HARDWARE-TIERS.md
- BRANCH-HYGIENE.md
- BRANCH-POLICY.md
- BRANCH-PROTECTION.md
- build-pipeline.md
- CFP-DEMO-SCRIPT.md
- CFP-FOSDEM-2027.md
- CFP-SCALE-21X.md
- CFP-SEAGL-2026.md
- ci-troubleshooting.md
- CI_SPEC.md
- DEVELOPER-GUIDE.md
- DISTROWATCH-SUBMISSION.md
- EDITION-VARIANT-PAGE-CHECKLIST.md
- EDUCATION-PITCH.md
- ELEMENTARY-CROSSPOST.md
- FEDIVERSE-PLAYBOOK.md
- FEDORA-MAGAZINE-PITCH.md
- FEDORA45-TESTING-CALL.md
- GREEN-CRITERIA.md
- GREEN-MASTER-PLAN.md
- HACKTOBERFEST-2026.md
- HARDWARE.md
- HUMMINGBIRD.md
- IMAGE-FACTORY-GATE.md
- IMAGE-FACTORY-LIFECYCLE-GATE.md
- IMAGE-TAGS.md
- IMPROVEMENT_PLAN.md
- INSTALL.md
- INSTALLER-FRONTENDS.md
- INSTALLER_SCREENSHOTS.md
- LUKS-TPM.md
- MARLIN-CACHYOS-POST.md
- matrix-provenance.json
- MATRIX-STATUS.md
- MATRIX-WEEKLY-DIGEST.md
- mkosi-investigation.md
- PIPELINE.md
- PRESSKIT.md
- Q3_CHECKPOINT-2026-08-22.md
- Q4-2026-PROMOTION-CALENDAR.md
- README.md
- REDDIT-LEMMY-PLAYBOOK.md
- rhel-setup.md
- ROLL_YOUR_OWN.md
- SCREENSHOTS.md
- SECURE-BOOT.md
- SHOWHN-LAUNCH.md
- TACKLEBOX-CONTRACT.md
- TESTING.md
- USER-GUIDE.md
- VERIFY-ARTIFACTS.md
- YOUTUBER-REVIEW-KIT.md
- - bootc-image-factory-build.service
  - bootc-image-factory-build.timer
- - README.md
- - README.md
- README.md
- configure_lts_iso_anaconda.sh
- custom-overlay.just
- qcow2-build.just
- utilities.just
- vm-pipeline.just
- - cosmic-arch.yaml
  - cosmic.yaml
  - gnome-arch.yaml
  - gnome-debian.yaml
  - gnome.yaml
  - kde-arch.yaml
  - kde-debian.yaml
  - kde.yaml
  - niri-arch.yaml
  - niri.yaml
  - pantheon.yaml
  - xfce-arch.yaml
  - xfce.yaml
- - README.md
- - common.sh
  - e2e-assert.sh
  - pixel-gate.sh
- _registry.sh
- asahi-remote-switch.sh
- bench-gdm-paint.sh
- boot-gate-matrix.sh
- boot-gate.sh
- build-chunkah.sh
- build-image-inner.sh
- build-iso-group.sh
- build-iso-tacklebox.sh
- build-qcow2.sh
- check-base-image-pins.sh
- check-package-repo-pins.py
- check-package-sources.py
- check-workflow-push.sh
- corral-build.sh
- desktop-verify.py
- diff-images.sh
- e2e-installer-gui-checks.sh
- e2e-luks-checks.sh
- e2e-smoke-checks.sh
- gen-matrix-status.py
- gen-screenshot-gallery.sh
- generate-boot-report.py
- generate-workflows.py
- get-base-image.sh
- gfi-pool-report.sh
- import-frontend-parity.py
- install-test.sh
- installer-walkthrough.py
- iso-e2e-gpu.sh
- iso-e2e.sh
- lifecycle-test.sh
- lima-novnc.sh
- luks-first-boot.py
- package-parity.sh
- packages_to_spdx.py
- pipeline-overview.sh
- pipeline.sh
- published-image-ref.sh
- README.md
- rechunk.sh
- record-timelapse.sh
- registry.sh
- report-missing-packages.sh
- rerun-startup-failures.py
- resolve-flavor.sh
- resolve-image.sh
- run-vm.sh
- run-walkthrough.sh
- setup-build-cache.sh
- simulate-matrix.sh
- sync-build-cache.sh
- sync-upstream-snapshots.sh
- verify-asahi-image.sh
- verify-experience-manifest.py
- verify-image-packages.sh
- verify-iso.sh
- verify-manifest-packages.sh
- - rpm-ostreed.conf
- - common_test.bats
  - test_10_base_packages.bats
  - test_adopters_evidence.bats
  - test_apt_x11_display_stack.bats
  - test_artifact_signing.bats
  - test_asahi_promotion_gate.bats
  - test_asahi_remote_switch.bats
  - test_asahi_sailfin_staging.bats
  - test_boot_gate_resume.bats
  - test_bootc_containers_policy.bats
  - test_bootc_dracut_config.bats
  - test_bootc_ostree_layout.bats
  - test_build_cache.bats
  - test_build_chunkah.bats
  - test_build_image_retry.bats
  - test_build_iso_group.bats
  - test_build_iso_tacklebox.bats
  - test_build_libostree.bats
  - test_build_live_iso.bats
  - test_build_qcow2.bats
  - test_build_scripts.bats
  - test_build_scripts_remaining.bats
  - test_build_status_classification.bats
  - test_cachyos_overlay.bats
  - test_check_workflow_push.bats
  - test_chunkah_rechunk.bats
  - test_codec_baseline.bats
  - test_containerfile_context.bats
  - test_containerfile_context_scripts.bats
  - test_containerfile_identity_env.bats
  - test_cosign_retry.bats
  - test_cosmic_apt_package_names.bats
  - test_cosmic_display_manager.bats
  - test_cosmic_dm_agreement.bats
  - test_cosmic_live_greeter_mask.bats
  - test_custom_overlay.bats
  - test_customize_live.bats
  - test_declared_flavors_installable.bats
  - test_desktop_contract_fatal.bats
  - test_desktop_script_apt_branch.bats
  - test_diff_images.bats
  - test_dracut_tpm2_userspace.bats
  - test_e2e_runtime_ssh_reachability.bats
  - test_eln_codec_gap.bats
  - test_fedora_base_currency.bats
  - test_fish_codename_table.bats
  - test_fisherman_override_order.bats
  - test_flatpak_preinstall.bats
  - test_functional_run.bats
  - test_gentoo_dracut_config.bats
  - test_gentoo_openssh.bats
  - test_get_base_image.bats
  - test_guppy_unsupported_desktops.bats
  - test_hacktoberfest_pool.bats
  - test_hummingbird_desktop_wiring.bats
  - test_install_rawhide_tolerant.bats
  - test_install_test.bats
  - test_installer_branding.bats
  - test_installer_credits.bats
  - test_installer_recipe_backend.bats
  - test_installer_tour_images.bats
  - test_iso_e2e.bats
  - test_iso_e2e_fisherman_override.bats
  - test_iso_e2e_install_timeout.bats
  - test_iso_e2e_offline_store_probe.bats
  - test_iso_e2e_poweroff.bats
  - test_justfile.bats
  - test_kde_display_manager.bats
  - test_language_boundary.bats
  - test_lib.bats
  - test_lima_novnc.bats
  - test_live_installer_launch.bats
  - test_live_podman_every_base.bats
  - test_live_ready_net_diagnostic.bats
  - test_live_sudo_contract.bats
  - test_live_sudo_every_base.bats
  - test_luks_tpm2_enroll_script.bats
  - test_luks_tpm2_support_matrix.bats
  - test_niri_dms_payload.bats
  - test_niri_wallpaper_daemon.bats
  - test_nvidia_overlay.bats
  - test_nvidia_overlay_arch_debian.bats
  - test_nvidia_releasever_is_one_line.bats
  - test_oci_metadata_no_personal_identity.bats
  - test_overlay_refreshes_system_files.bats
  - test_package_wishlist_gate.bats
  - test_pipeline.bats
  - test_pixel_gate.bats
  - test_pkg_retry_parity.bats
  - test_plymouth_themes.bats
  - test_press_claims_match_roadmap.bats
  - test_published_image_ref.bats
  - test_rawhide_rpmdb_probe.bats
  - test_rechunk.bats
  - test_record_timelapse.bats
  - test_registry.bats
  - test_registry_ref.bats
  - test_report_missing_packages.bats
  - test_resolve_flavor.bats
  - test_reusable_workflow_inputs.bats
  - test_sbom_scope.bats
  - test_screens_not_greeter.bats
  - test_selinux_store_copyup.bats
  - test_signing_trust_boundary.bats
  - test_sync_upstream_snapshots.bats
  - test_tailscale_repo_selection.bats
  - test_test_yml_pytest_always_runs.bats
  - test_testing_call_claims.bats
  - test_ubuntu_kernel.bats
  - test_ubuntu_libostree.bats
  - test_untested_scripts_v2.bats
  - test_verify_asahi_el10.bats
  - test_verify_image_packages.bats
  - test_verify_iso.bats
  - test_verify_manifest_packages.bats
  - test_xfce_greeter_contract.bats
- - verify.yaml
- - ublue-common-policy.json
- - run.sh
- - fake-qemu-serial.py
  - luks-first-boot-contract.sh
- - test_check_el10_packages.py
  - test_desktop_verify.py
- - test_generate_boot_report.py
- - .gitkeep
- anaconda-ks.cfg
- installer-screens.yaml
- lima-template.yaml
- live-iso-verify.yaml
- README.md
- test_a_failing_live_customize_fails_fast.py
- test_a_job_budget_covers_its_own_steps.py
- test_a_rolling_snapshot_pin_cannot_go_stale_unnoticed.py
- test_a_waived_desktop_contract_does_not_report_pass.py
- test_automation_does_not_push_to_main.py
- test_base_image_pins_are_checked.py
- test_boot_gate_blocks_green.py
- test_boot_gate_ownership.py
- test_boot_report.py
- test_boot_report_gh.py
- test_build_ceiling_clears_the_slowest_variant.py
- test_changelogs.py
- test_composite_green_scoring.py
- test_declared_flavors_are_implemented.py
- test_desktop_verify.py
- test_every_iso_build_installs_working_podman.py
- test_expensive_builds_collapse_redundant_pr_runs.py
- test_experience_manifest.py
- test_fire_copilot_batch.py
- test_generate_workflows.py
- test_ghcr_login_podman_sudo_retry.py
- test_gitmodules.py
- test_green_criteria.py
- test_green_master_plan.py
- test_guppy_kde_binhost_version_lock.py
- test_hummingbird_arm64_honesty.py
- test_hummingbird_base_can_reach_an_iso.py
- test_image_aliases.py
- test_import_frontend_parity.py
- test_installer_asset_is_arch_aware.py
- test_installer_smoke_needs_no_gpu.py
- test_installer_walkthrough.py
- test_iso_scripts_run_containers_on_a_usable_log_driver.py
- test_just_fix_does_not_strand_prs_in_unstable.py
- test_just_modules_resolve_repo_paths.py
- test_kvm_jobs_run_where_kvm_exists.py
- test_lifecycle_arm64_podman_is_not_a_mixed_stack.py
- test_luks_first_boot.py
- test_matrix_status.py
- test_matrix_status_config.py
- test_matrix_status_fetch.py
- test_nightly_schedule_registry.py
- test_no_workflow_hoards_multi_gigabyte_artifacts.py
- test_omissions_manifest_is_read_on_a_schedule.py
- test_one_failing_flavor_cannot_skip_a_sibling_iso.py
- test_one_iso_per_base_and_desktop.py
- test_package_parity_is_scheduled.py
- test_package_repo_pins_are_checked.py
- test_package_source_policy.py
- test_per_variant_install_overrides_reach_the_image.py
- test_promote_retries_skopeo_copy.py
- test_rawhide_probe_scope.py
- test_readiness_stamp_lookup.py
- test_readme_build_status_refresh.py
- test_rerun_startup_failures.py
- test_sailfin_keeps_packman_codecs.py
- test_sbom_falls_back_to_the_package_manifest.py
- test_sbom_step_cannot_kill_the_variant.py
- test_sign_step_retries_cosign.py
- test_the_flatpak_install_names_what_is_available.py
- test_the_iso_build_runner_is_switchable.py
- test_the_iso_e2e_can_address_every_cell.py
- test_the_on_guest_checks_actually_run.py
- test_the_progress_screen_keywords_were_measured.py
- test_the_seat_diagnostic_collects_evidence.py
- test_the_stamp_lookup_matches_flatpak.py
- test_the_welcome_keywords_match_what_kde_says.py
- test_ubuntu_uid_1000_is_free.py
- test_workflow_conditions_name_real_inputs.py
- test_workflow_expressions_parse.py
- test_write_gemini_task.py
- Containerfile.debian
.devcontainer.json
.gitattributes
.gitignore
.gitmodules
.pre-commit-config.yaml
.yamllint.yml
ADOPTERS.md
ADOPTION-METRICS.md
AGENTS.md
artifacthub-repo.yml
CODE_OF_CONDUCT.md
COMMUNITY.md
Containerfile.arch
Containerfile.custom
Containerfile.debian
Containerfile.el10
Containerfile.final
Containerfile.gentoo
Containerfile.opensuse
Containerfile.overlay
Containerfile.ubuntu
CONTRIBUTING.md
cosign.pub
FEDORA-BASE-POLICY.md
GOAL.md
image-versions.yaml
Justfile
LICENSE
MAINTAINERS.md
MIGRATION.md
PACKAGE-SOURCING.md
pytest.ini
Q3_CHECKPOINT-2026-08-22.md
Q4-ADOPTION-PLAN.md
Q4-MATURE-DEFINITION.md
README.md
registry-map.yaml
renovate.json
RFC-PROCESS.md
ROADMAP.md
SECURITY.md
TRIAGE-POLICY.md
tunaos-builder.yaml
VARIANT-LIFECYCLE.md
VERSIONING.md
VISION.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`brew`

View Details ▼

Homebrew - a package manager for macOS and Linux.
Some subcommands such as `install` have their own usage documentation.

brew install {{formula|cask}}

Install the latest stable version of a formula or cask:

brew list

List all installed formulae and casks:

brew upgrade {{formula|cask}}

Upgrade an installed formula or cask (if none is given, all installed formulae/casks are upgraded):

🔍

`just`

View Details ▼

Save and run project-specific commands.

just {{recipe}}

Run a recipe specified in the justfile:

just

Start a REPL (interactive shell):

just --init

Initialize new justfile in project root:

🔍

`bootc switch`

View Details ▼

Target a new container image reference to boot.

sudo bootc switch {{image}}

Change the base OS to a new container image from a registry:

sudo bootc switch --transport containers-storage {{image}}

Change the base OS to a new container image from the local image storage of the root user:

sudo bootc switch --transport oci-archive {{path/to/image.tar.gz}}

Change the base OS to a new container image stored in a tarball:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

tunaOS

Owner Repos

File Explorer

# Use via CDN

Command Glossary

`brew`

`just`

`bootc switch`

Was this content helpful?

Recent Feedback

tunaOS

Owner Repos

File Explorer

# Use via CDN

Command Glossary

brew

just

bootc switch

Was this content helpful?

Recent Feedback

Download README

`brew`

`just`

`bootc switch`