Skip to main content
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 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: 
apiVersion: v1alpha1 # version of the document
kind: NetworkRuleConfig # type of document
name: rule1 # only for named documents
Note: YAML treats certain characters,such as !, ?, *, and &, as part of its own syntax. When defining configuration values that include these characters (for example, in selectors or filters like diskSelector or network.interfaces.match in the Machine Config), wrap them in quotes ("...") to ensure they are parsed correctly.
This section contains the configuration reference, to learn more about Talos Linux machine configuration management, please see: