| 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) - RHEL for Edge (
r4e) - Fedora IoT (
fiot)
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) - RHEL for Edge (
r4e) - Fedora IoT (
fiot)
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 | 3.4.0 |
fcos |
1.6.0-experimental | 3.5.0-experimental |
flatcar |
1.0.0 | 3.3.0 |
flatcar |
1.1.0 | 3.4.0 |
flatcar |
1.2.0-experimental | 3.5.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 | 3.2.0 |
openshift |
4.13.0 | 3.2.0 |
openshift |
4.14.0 | 3.4.0 |
openshift |
4.15.0 | 3.4.0 |
openshift |
4.16.0 | 3.4.0 |
openshift |
4.17.0-experimental | 3.5.0-experimental |
r4e |
1.0.0 | 3.3.0 |
r4e |
1.1.0 | 3.4.0 |
r4e |
1.2.0-experimental | 3.5.0-experimental |
fiot |
1.0.0 | 3.4.0 |
fiot |
1.1.0-experimental | 3.5.0-experimental |