| has_children | nav_order | has_toc |
|---|---|---|
true |
4 |
false |
Butane Configs must conform to a specific variant and version of the Butane schema, specified with the variant and version fields in the configuration.
See the Upgrading Configs page for instructions to update a configuration to the latest specification.
We recommend that you always use the latest stable specification for your operating system to benefit from new features and bug fixes. The following stable specification versions are currently supported in Butane:
- Fedora CoreOS (
fcos) - Flatcar (
flatcar) - OpenShift (
openshift)
Do not use experimental specifications for anything beyond development and testing as they are subject to change without warning or announcement. The following experimental specification versions are currently available in Butane:
- Fedora CoreOS (
fcos) - Flatcar (
flatcar) - OpenShift (
openshift)
The following configuration specifications are still accepted by Butane but are deprecated and will be removed in a future release:
- RHEL CoreOS (
rhcos)
Each version of the Butane specification corresponds to a version of the Ignition specification:
| Butane variant | Butane version | Ignition spec |
|---|---|---|
fcos |
1.0.0 | 3.0.0 |
fcos |
1.1.0 | 3.1.0 |
fcos |
1.2.0 | 3.2.0 |
fcos |
1.3.0 | 3.2.0 |
fcos |
1.4.0 | 3.3.0 |
fcos |
1.5.0-experimental | 3.4.0-experimental |
flatcar |
1.0.0 | 3.3.0 |
flatcar |
1.1.0-experimental | 3.4.0-experimental |
openshift |
4.8.0 | 3.2.0 |
openshift |
4.9.0 | 3.2.0 |
openshift |
4.10.0 | 3.2.0 |
openshift |
4.11.0 | 3.2.0 |
openshift |
4.12.0-experimental | 3.4.0-experimental |
rhcos |
0.1.0 | 3.2.0 |