Skip to content

coreos/ignition

Folders and files

NameName
Last commit message
Last commit date
May 30, 2023
Mar 12, 2025
Mar 6, 2023
Oct 14, 2024
Mar 19, 2025
Feb 13, 2025
Jul 23, 2021
Mar 19, 2025
Sep 5, 2017
Mar 11, 2025
May 3, 2022
Oct 14, 2024
Aug 9, 2022
Mar 10, 2025
Nov 21, 2023
Sep 5, 2017
May 5, 2021
Apr 3, 2015
Nov 25, 2024
Mar 4, 2015
Mar 19, 2025
May 24, 2022
Apr 3, 2015
Jun 17, 2024
Sep 10, 2024
Jul 29, 2020
Mar 21, 2022
Jan 8, 2018
Oct 14, 2024
Mar 10, 2025
Mar 10, 2025
Dec 16, 2024
May 30, 2023
Oct 11, 2024

Ignition

Ignition is a utility created to manipulate disks during the initramfs. This includes partitioning disks, formatting partitions, writing files (regular files, systemd units, etc.), and configuring users. On first boot, Ignition reads its configuration from a source of truth (remote URL, network metadata service, hypervisor bridge, etc.) and applies the configuration.

Usage

Odds are good that you don't want to invoke Ignition directly. In fact, it isn't even present in the root filesystem. Take a look at the Getting Started Guide for details on providing Ignition with a runtime configuration.

Known users

  • Fedora CoreOS
  • Red Hat Enterprise Linux CoreOS
  • Flatcar
  • openSUSE MicroOS
  • SUSE Linux Enterprise Micro

Contact

Contributing

See CONTRIBUTING for details on submitting patches and the contribution workflow.

To help triage or fix bugs, see the current Ignition issues.

Config Validation

To validate a config for Ignition there are binaries for a cli tool called ignition-validate available on the releases page. There is also an ignition-validate container: quay.io/coreos/ignition-validate.

Example:

# This example uses podman, but docker can be used too
podman run --pull=always --rm -i quay.io/coreos/ignition-validate:release - < myconfig.ign