Go to file

Mathias Beaulieu-Duncan ee085a7606 Replace version table with Docker-style badges for all components Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>		2026-02-13 16:56:46 -05:00
.gitea/workflows	Add SBOM attestations to installer/release images, remove Scout	2026-02-13 16:48:56 -05:00
config	Initial commit: Talos CM5 builder with Gitea CI/CD	2026-02-09 17:58:17 -05:00
patches	Fix 21 Go stdlib CVEs and enable supply chain attestations	2026-02-13 15:36:13 -05:00
scripts	Add daily auto-update workflow and fix overlay dirty tag	2026-02-13 15:05:46 -05:00
.gitignore	Initial commit: Talos CM5 builder with Gitea CI/CD	2026-02-09 17:58:17 -05:00
cosign.pub	Add SBOM attestations to installer/release images, remove Scout	2026-02-13 16:48:56 -05:00
LICENSE	Add LICENSE, update README, upgrade provenance to max-mode	2026-02-13 15:57:11 -05:00
Makefile	Add SBOM attestations to installer/release images, remove Scout	2026-02-13 16:48:56 -05:00
README.md	Replace version table with Docker-style badges for all components	2026-02-13 16:56:46 -05:00
TECHNICAL.md	Split README into user manual and TECHNICAL.md	2026-02-13 16:55:37 -05:00

README.md

Talos CM5 Builder

Custom Talos Linux images for Raspberry Pi 5 / CM5 on Compute Blade hardware.

The official Talos Image Factory does not support CM5 — the mainline kernel lacks CM5 device trees and RP1 driver support. This builder uses the RPi downstream kernel (via talos-rpi5/talos-builder patches) to produce working CM5 images with our extensions and overclock config.

Current versions

Component	Version
Talos Linux
RPi Kernel
iscsi-tools
util-linux-tools

Image tags

Release images are published to docker.io/svrnty/talos-rpi5 with the format:

v<talos>-k<kernel>-<revision>

For example: v1.12.3-k6.12.47-2

Segment	Meaning
`v1.12.3`	Upstream Talos Linux version
`k6.12.47`	RPi downstream kernel version
`2`	Build revision (bumped for config/patch changes on the same upstream versions)

Usage

Install from raw disk image

Download metal-arm64.raw.zst from the latest release and flash to eMMC:

zstd -d metal-arm64.raw.zst -o metal-arm64.raw
# Flash to eMMC/SD via your preferred tool (dd, balenaEtcher, etc.)

Upgrade an existing node

talosctl upgrade --image docker.io/svrnty/talos-rpi5:v1.12.3-k6.12.47-2

What's included

RPi downstream kernel with CM5/RP1 support
Overclock: 2.6GHz (arm_freq=2600, over_voltage_delta=50000, arm_boost=1)
Extensions: iscsi-tools, util-linux-tools

Building

For local builds, CI/CD setup, runner configuration, and project structure, see TECHNICAL.md.

License

This project is licensed under the Mozilla Public License 2.0.

It builds upon the following MPL 2.0 licensed upstream projects:

siderolabs/talos — Talos Linux OS
siderolabs/pkgs — Talos package definitions
talos-rpi5/sbc-raspberrypi5 — Raspberry Pi 5 SBC overlay

Our patches to these projects are in the patches/ directory and are distributed under the same MPL 2.0 terms.