talos README

The project's README from github.com/siderolabs/talos. As one markdown file: README.md.

Talos Linux

A modern OS for Kubernetes.

Release Pre-release OpenSSF badge


Talos is a modern OS for running Kubernetes: secure, immutable, and minimal. Talos is fully open source, production-ready, and supported by the people at Sidero Labs. All system management is done via an API - there is no shell or interactive console. Benefits include:

Documentation

For instructions on deploying and managing Talos, see the Documentation.

Community

If you're interested in this project and would like to help in engineering efforts or have general usage questions, we are happy to have you! We hold a monthly meeting that all audiences are welcome to attend.

We would appreciate your feedback so that we can make Talos even better! To do so, you can take our survey.

Office Hours

Note: You can convert the meeting hours to your local time.

Contributing

Contributions are welcomed and appreciated! See Contributing for our guidelines.

License

GitHub

Some software we distribute is under the General Public License family of licenses or other licenses that require we provide you with the source code. If you would like a copy of the source code for this software, please contact us via email: info at SideroLabs.com.

talos (siderolabs/talos)

Searching Database…

11.4K ·GitHub
What is this?Talos is a modern Linux-based operating system built specifically for running Kubernetes: secure, immutable, and minimal, with all system management done through an API instead of a shell.
Is this a regular Linux distro I can SSH into?No, Talos has no shell or interactive console at all; every management action goes through its API, since the OS is treated as immutable infrastructure rather than a server you log into.
How do I get a Talos cluster running?The README doesn't include inline setup commands; it points directly to Talos' own documentation site for instructions on deploying and managing a cluster.
Do I need anything special to manage a Talos node?You manage Talos entirely through its API over mutual TLS, so you need the API client and certificates rather than SSH keys or a terminal.
How do I debug or configure a node if there's no shell?Everything, including configuration and troubleshooting, has to go through Talos' mTLS-secured API by design, since interactive console access was intentionally removed to reduce attack surface.
Who is this really for?Talos targets platform and DevOps teams running production Kubernetes who want an immutable, atomically-updated OS instead of a general-purpose Linux box.
Is the license straightforward?Talos itself is MPL-2.0, but some bundled components fall under GPL-family licenses that require Sidero Labs to supply source code on request.
What does 'immutable' actually mean for Talos?Talos treats the OS as immutable infrastructure, eliminating configuration drift by delivering whole, atomic updates instead of letting admins patch files in place over time.
Why use Talos instead of a general-purpose Linux distro for Kubernetes nodes?Without a shell, package manager, or mutable state, Talos has a drastically smaller attack surface and more predictable behavior than a standard distro running kubelet.
Does Talos always run the latest Kubernetes and Linux?Yes, part of its design goal is to always deliver current, stable versions of both Kubernetes and the underlying Linux kernel.
Creator
siderolabs
Size
101.7 MB
Stars
11.4K
Age
8y
Commits · 90 Days