APT Repository

APT Repository

SkillFishOS ships a signed APT repository (codename aetherium) that delivers the custom kernel and every native app as updatable .debs.

Where it lives

• Built with reprepro on the build machine; suite aetherium, component main, architectures amd64 i386 source, GPG-signed.
• Served primarily from GitHub Pages: https://mtsistemi.github.io/SkillFishOS
• Mirror 2 — OVH: https://skillfishos.com/apt
• Mirror 3 — SourceForge Project Web: https://skillfishos.sourceforge.io/apt

All three serve the same signed tree, so any of them can be used in skillfishos.sources by swapping the URIs: line — the signature check is identical.

Client setup (already on the ISO)

The installed system already has:

• skillfishos-archive-keyring — the signing key.
• /etc/apt/sources.list.d/skillfishos.sources (deb822) pointing at https://mtsistemi.github.io/SkillFishOS aetherium main.

So apt update && apt full-upgrade, the SkillFishOS Hub, or KDE Discover all pull SkillFishOS updates alongside Debian's.

What's in it

Package	Notes
skillfishos-kernel	thin wrapper that fetches the full kernel .deb from the GitHub Release
skillfish-tuner	SkillFishOS Tuner
skillfish-hub	SkillFishOS Hub
skillfish-ai-panel	on-device AI panel
skillfish-monitor	live sensor charts
skillfish-kernel-manager	kernel chooser / remover
skillfish-iso-mount	Dolphin ISO mounting
skillfish-menu	the "SkillFishOS" submenu

i386 is populated by reprepro flood so the Architecture: all packages resolve on every arch.

Snapshots = a safety net

Because Snapper takes a Btrfs snapshot before and after every apt transaction (with @home kept separate), a bad update is one GRUB rollback away — see Installation.

Publishing (maintainers)

Bump the package version → reprepro includedeb aetherium <deb> → reprepro flood aetherium i386 → tar dists+pool+keyring → publish to the gh-pages branch and mirror to OVH. The kernel image is published as a GitHub Release asset (it exceeds the 100 MB GitHub Pages limit) and pulled out-of-band by the wrapper's postinst.