v3.4.2

What's Changed

• Fix the release artifacts name for standard. They were missing a v in front of the kubernetes version
• Update framework to provide an upgraded suc-upgrade that will work for 3.4.x branch. Otherwise when upgrading via kubernetes the version check will always pass and would never upgrade to a newwer version.

Full Changelog: v3.4.1...v3.4.2

v3.4.1

What's Changed

• Upgraded kairos-init to 0.4.7 which fixes the following issues:
  • ssh host keys changed during upgrade: After an upgrade the ssh host keys would not match. That has been fixed and was an leftover from the docker build process. Now kairos-init will clean up the hosts keys after building
  • Fixed rhel family builds: Rhel and derivatives builds were missing systemd-networkd and the epel repository. Also they did ship a masked getty.target which prevented isos and installed systems from presenting a login prompt on the expected ttys.

Full Changelog: v3.4.0...v3.4.1

v3.4.0

Kairos v3.4.0

Kairos 3.4.0 is a landmark release that simplifies how Kairos is built, deployed, and customized. With a rebuilt foundation, expanded cloud presence, and new runtime flexibility, it opens the door to even more powerful workflows for OS builders and operators.

✨ Highlights

New Build System with kairos-init

We've dropped Earthly and rebuilt the Kairos build process from scratch. The new system uses kairos-init, inspired by Yip, to provide a faster, more transparent, and easier-to-extend pipeline.
The new Kairos factory docs are now the recommended way to build custom Kairos derivatives and images—clean, composable, and fully documented.
👉 Blog post
👉 Kairos factory docst

Official Cloud Images for AWS, Azure, and GCP

Kairos now ships official images directly to all major clouds—no more manual imports. Launch Kairos instances right from your cloud console.
👉 AWS Guide
👉 Azure Guide
👉 GCP Guide

k0s Integration: A Meta-Distribution for Kubernetes

With k0s now natively supported, Kairos becomes a lightweight Kubernetes OS with full declarative lifecycle control.
👉 Blog post
👉 Docs have been updated to reflect k0s support and now can be toggled to show how to configure k0s and k3s.

System Extensions for Live Customization

Extend and reconfigure running systems without rebuilding images using the new declarative system extension framework.
👉 Blog post
👉 Sysext docs

🔧 Additional Updates

Base image updates:

• Alpine bumped to 3.21
• NVIDIA Orin builds now based on Ubuntu 22.04 (was 20.04)
• Debian artifact names standardized (e.g., debian-bookworm → debian-12)

Improved logging behavior across all Kairos-built binaries

• Logs now go to journald on systemd-based distributions
• On non-systemd systems, logs are written to a single, thread-safe file under /var/log/kairos/

kairos-agent: Upgraded to v2.20.4

• Introduced support for system extension management commands: install, remove, enable, and disable. See CLI docs for extended info on the supported commands.
• Adding grub env vars will no longer overwrite the existing ones. Agent will now reaed the existing file (if any) and append the new vars to it, avoiding any destructive actions.

Yip libraries updated with new modules and conditionals:

• systemctl module can now easily create overrides for systemd services

• New install plugin allows OS-agnostic package management (note: not applicable to immutable Kairos images)

• New unpackImage plugin supports pulling and unpacking remote OCI images into the local system

• New conditional fields:

  • only_os, only_os_version: apply stages to specific distros or versions using regex
  • only_arch, only_service_manager: match based on system architecture or init system

• In debug mode, Yip now logs both command output and error output for easier troubleshooting

• For full info of the new cloud-config plugins and conditional please check the Yip docs

• Streamlined CI pipelines and expanded test coverage. Thanks to the speed up in building due to the change to kairos-init, we are able to have more tests and build more flavors and arches in our CI jobs.

• Numerous bug fixes and performance improvements

New Contributors

• @jimmycathy made their first contribution in #3255

Full Changelog: v3.3.6...v3.4.0

v3.4.0-rc6

Full Changelog: v3.4.0-rc5...v3.4.0-rc6

v3.4.0-rc5

What's Changed

• ⬆️ Update quay.io/kairos/kairos-init Docker tag to v0.4.5 by @renovate in #3354
• Add grype critical check with details by @Itxaka in #3355
• Add grype detail check to uki as well by @Itxaka in #3356
• Add grype ignore file by @Itxaka in #3357
• ⬆️ Update github/codeql-action digest to 28deaed by @renovate in #3281
• ⬆️ Update actions/upload-artifact action to v4.6.2 by @renovate in #3282
• ⬆️ Update actions/setup-go digest to 0aaccfd by @renovate in #3279
• ⬆️ Update actions/upload-artifact digest to ea165f8 by @renovate in #3280
• ⬆️ Pin tj-actions/changed-files action to ed68ef8 by @renovate in #3313
• ⬆️ Update module github.com/onsi/ginkgo/v2 to v2.23.4 by @renovate in #3283
• ⬆️ Update module github.com/diskfs/go-diskfs to v1.6.0 by @renovate in #3339
• ⬆️ Update azure/login digest to a457da9 by @renovate in #3312
• ⬆️ Update module github.com/onsi/gomega to v1.37.0 by @renovate in #3292
• Create osv-scanner.yml by @Itxaka in #3358

Full Changelog: v3.4.0-rc4...v3.4.0-rc5

v3.4.0-rc4

What's Changed

• Revert ":arrow_up: Update softprops/action-gh-release action to v2.2.2" by @Itxaka in #3351

Full Changelog: v3.4.0-rc3...v3.4.0-rc4

v3.4.0-rc3

What's Changed

• Update Framework by @Itxaka in #3350

Full Changelog: v3.4.0-rc2...v3.4.0-rc3

v3.4.0-rc2

Full Changelog: v3.4.0-rc1...v3.4.0-rc2

v3.4.0-rc1

What's Changed

• 3175 add AWS smoke test by @jimmykarily in #3317
• 3175 add gcp smoke test by @jimmykarily in #3327
• 3175 test azure by @jimmykarily in #3333
• ⬆️ Update quay.io/kairos/kairos-init Docker tag to v0.4.4 by @renovate in #3328
• Disable ovs scan by @Itxaka in #3338
• bug: Fix bundle tests by @Itxaka in #3337
• Add debug output when the test fails by @jimmykarily in #3340
• Re-enable decentralized test by @jimmykarily in #3341
• Fix the nvidia orin build on master by @Itxaka in #3345
• ⬆️ Update softprops/action-gh-release action to v2.2.2 by @renovate in #3343
• Improve test jobs by @Itxaka in #3346
• Fix decentralized test by @Itxaka in #3348

Full Changelog: v3.4.0-beta9...v3.4.0-rc1

v3.4.0-beta9

What's Changed

• Push cloud images when a new tag is created by @jimmykarily in #3301

Full Changelog: v3.4.0-beta8...v3.4.0-beta9