Skip to main content

index

Archived

The tuna-os/tromso-iso repository was archived on 2026-06-12. Live ISOs for the KDE desktop are now built and published from the main tunaOS pipeline — see tunaos.org/download for current builds. This page is kept for historical reference only.

Live ISO installer for Tromso KDE Linux — a KDE Plasma 6 desktop built on freedesktop-sdk with bootc-powered atomic updates.

Based on projectbluefin/dakota-iso.

Architecture​

Three-stage Containerfile build:

  1. tromso-ref — pull ghcr.io/tuna-os/tromso:latest (kernel modules source)
  2. initramfs-builder — Debian: build a dmsquash-live initramfs against Tromso's kernel modules
  3. final — Tromso image with replaced initramfs + SDDM autologin + tuna-installer + flatpaks

The ISO uses systemd-boot (no GRUB2, no shim). The live environment boots via dmsquash-live (squashfs + overlayfs), autologs into a KDE Plasma session as liveuser, and auto-launches the tuna-installer flatpak for graphical installation.

Building Locally​

Prerequisites: podman, buildah, just, mtools, xorriso, skopeo

# Build the live ISO
just iso-sd-boot tromso

# Output: output/tromso-live.iso

For background builds with logging:

just build-bg tromso

On machines with limited disk space, use an XFS loopback at /mnt for VFS import:

sudo just mount-xfs
sudo just workdir=/mnt iso-sd-boot tromso

Installation​

  1. Write the ISO to USB: dd if=output/tromso-live.iso of=/dev/sdX bs=4M status=progress
  2. Boot from USB
  3. The Tromso Installer launches automatically in the live KDE session
  4. Select your disk and install

CI​

Builds trigger on:

  • Push to tromso/** or justfile
  • Daily schedule (05:00 UTC) to pick up Tromso image updates
  • repository_dispatch with type oci-image-published (triggered by tuna-os/tromso)
  • Manual workflow_dispatch

Built ISOs are published as GitHub Releases.

Icons & Branding​

Place icon files at:

tromso/src/icons/hicolor/{16,24,32,48,64,128,256,512}x{16,24,32,48,64,128,256,512}/apps/tromso.png

Place installer tour image at:

tromso/src/images/tromso-welcome.png

These are optional — the installer will fall back to generic assets if not present.