You are viewing the development docs which are in progress. There is no guarantee that the development documentation will be accurate, including instructions, links, and other information. For the latest stable documentation, click here.

Documentation

Explore the official documentation for Kairos and discover how it simplifies lifecycle management across edge, cloud, and bare metal environments.

Welcome to the Kairos master Documentation

Kairos is the open-source project that simplifies Edge, cloud, and bare metal OS lifecycle management. With a unified Cloud Native API, Kairos is community-driven, open source, and distro agnostic.

In this documentation, you will find everything you need to know about Kairos, from installation and configuration, to examples and advanced features.

For more information, go ahead and check the sections bellow. If you have any questions or feedback, feel free to open an issue or join our community forum.


Announcements

A single stop to learn about Known Issues, Deprecation Warnings and/or Remarkable Changes in this release

Installation

Discover multiple ways to install Kairos across cloud, bare metal, and virtualized environments.

Upgrade

Learn how to keep Kairos systems up-to-date using manual methods, Kubernetes-based upgrades, and trusted boot options.

Architecture

Deep dive into Kairos architecture. Here you will learn in detail how the main features of Kairos have been designed.

Advanced

Learn how to configure advanced Kairos features such as system extensions, partitions, bundles, and confidential computing.

Examples

Explore hands-on examples that show how to deploy Kairos clusters using K3s, bundles, VPNs, airgapped environments, and more.

Reference

Access essential reference materials for configuring, building, and troubleshooting Kairos nodes and images.

Development

Want to help develop Kairos? This section will teach you about our development process so you can become a contributor

Media

Discover Kairos in action through videos, presentation slides, and other media resources.