> ## Documentation Index
> Fetch the complete documentation index at: https://siderolabs-fe86397c-1-11-reference.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Talos Linux machine configuration reference.

Talos Linux machine is fully configured via a single YAML file called *machine configuration*.

The file might contain one or more configuration documents separated by `---` (three dashes) lines.
At the moment, majority of the configuration options are within the [v1alpha1](./v1alpha1/config) document, so
this is the only mandatory document in the configuration file.

Configuration documents might be named (contain a `name:` field) or unnamed.
Unnamed documents can be supplied to the machine configuration file only once, while named documents can be supplied multiple times with unique names.

The `v1alpha1` document has its own (legacy) structure, while every other document has the following set of fields:

```yaml
apiVersion: v1alpha1 # version of the document
kind: NetworkRuleConfig # type of document
name: rule1 # only for named documents
```

This section contains the configuration reference, to learn more about Talos Linux machine configuration management, please see:

* [quick guide to configuration generation](../../getting-started/getting-started)
* [configuration management in production](../../getting-started/prodnotes)
* [configuration patches](../../configure-your-talos-cluster/system-configuration/patching)
* [editing live machine configuration](../../configure-your-talos-cluster/system-configuration/editing-machine-configuration)