index
An OCI image with XFCE Wayland, built through BuildStream — a lightweight and immutable OS image with the XFCE desktop.
Part of the TunaOS ecosystem.
Contribute compute — no code needed
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.
Features
- Lightweight — XFCE desktop optimized for low-resource systems
- Immutable — OCI-based, atomic updates via
bootc - Wayland — modern display protocol
- BuildStream — reproducible builds from source
Quick Start
# Pull the image
podman pull ghcr.io/tuna-os/xfce-linux:latest
# Switch an existing bootc system
sudo bootc switch ghcr.io/tuna-os/xfce-linux:latest
Stable release channel
The release workflow publishes the first stable channel only after all checks pass. The checks cover the nightly image, matching live ISO, plain install, and LUKS install. After promotion, use the immutable image at:
podman pull ghcr.io/tuna-os/xfce-linux:stable
sudo bootc switch ghcr.io/tuna-os/xfce-linux:stable
The workflow publishes the stable live ISO and checksum under
https://pub-<configured-r2-domain>/xfce-linux/stable/. Their names are
xfce-linux-live-latest.iso and xfce-linux-live-latest.iso-CHECKSUM.
The promotion workflow verifies both objects before it marks the release as
ready. Thus, downstream download pages can safely use those stable names.
Verifying Signatures
OCI images: Image signature verification is not yet in effect. See docs/signing.md for the implementation plan.
Live ISO signatures (.sig and .cert files accompany each dated ISO,
such as xfce-linux-live-<date>-<sha>.iso.sig):
cosign verify-blob xfce-linux-live-<date>-<sha>.iso \
--certificate xfce-linux-live-<date>-<sha>.iso.cert \
--signature xfce-linux-live-<date>-<sha>.iso.sig \
--certificate-identity-regexp '^https://github\.com/tuna-os/(brussels|xfce-linux)/\.github/workflows/build-iso\.yml@' \
--certificate-oidc-issuer https://token.actions.githubusercontent.com
Docs
License
Apache 2.0 — see LICENSE.