coreos-installer(8)

💖 NAME 💖

okay bestie, welcome to coreos-installer(8), the System Manager's Manual page that lives in your terminal and is about to become your whole personality 💅

coreos-installer-install — Install Fedora CoreOS or RHEL CoreOS ✨

---

🎀 SYNOPSIS 🎀

coreos-installer-install [-c|--config-file] [-s|--stream]
[-u|--image-url] [-f|--image-file] [-i|--ignition-file]
[-I|--ignition-url] [--ignition-hash] [-a|--architecture]
[-p|--platform] [--console] [--append-karg] [--delete-karg]
[-n|--copy-network] [--network-dir] [--save-partlabel]
[--save-partindex] [--offline] [--insecure] [--insecure-ignition]
[--stream-base-url] [--preserve-on-error] [--fetch-retries]
[--secure-ipl] [-h|--help] [-V|--version] [DEST_DEVICE]

---

🦋 DESCRIPTION 🦋

Install Fedora CoreOS or RHEL CoreOS. that's it, that's the whole vibe. no cap 🌈

---

✨ OPTIONS ✨

• -c, --config-file <path> — YAML config file with install options 📄 Load additional config options from the specified YAML config file. Later config files override earlier ones, and command-line options override config files. (so the command line is always the main character 👑)

Config file keys are long option names without the leading --. Values are strings for non-repeatable options, arrays of strings for repeatable options, and "true" for flags. The destination device can be specified with the "dest-device" key.

• -s, --stream <name> — Fedora CoreOS stream 🌊 The name of the Fedora CoreOS stream to install, such as "stable", "testing", or "next".
• -u, --image-url <URL> — Manually specify the image URL 🔗 coreos-installer appends .sig to find the GPG signature for the image, which must exist and be valid. A missing signature can be ignored with --insecure.
• -f, --image-file <path> — Manually specify a local image file 📁 coreos-installer appends .sig to find the GPG signature for the image, which must exist and be valid. A missing signature can be ignored with --insecure.
• -i, --ignition-file <path> — Embed an Ignition or Butane config from a file 🔥 Embed the specified Ignition JSON config or Butane YAML config in the installed system. Butane configs are identified by a top-level "variant" key and are passed through as-is; installed Ignition handles transpilation at first boot.
• -I, --ignition-url <URL> — Embed an Ignition or Butane config from a URL 🌐 Immediately fetch the Ignition JSON config or Butane YAML config from the URL and embed it in the installed system.
• --ignition-hash <digest> — Digest (type-value) of the Ignition config 🧾 Verify that the Ignition config matches the specified digest, formatted as <type>-<hexvalue>. <type> can be sha256 or sha512.
• -a, --architecture <name> [default: x86_64] — Target CPU architecture 🖥️ Create an install disk for a different CPU architecture than the host.
• -p, --platform <name> — Override the Ignition platform ID ☁️ Install a system that will run on the specified cloud or virtualization platform, such as "vmware".
• --console <spec> — Kernel and bootloader console ⌨️ Set the kernel and bootloader console, using the same syntax as the parameter to the "console=" kernel argument.
• --append-karg <arg> — Append default kernel arg ➕ Add a kernel argument to the installed system.
• --delete-karg <arg> — Delete default kernel arg ➖ Delete a default kernel argument from the installed system.
• -n, --copy-network — Copy network config from install environment 📡 Copy NetworkManager keyfiles from the install environment to the installed system.
• --network-dir <path> — Override NetworkManager keyfile dir for -n 🗂️ Specify the path to NetworkManager keyfiles to be copied with --copy-network.

[default: /etc/NetworkManager/system-connections/]

• --save-partlabel <lx> — Save partitions with this label glob 🏷️ Preserve any existing partitions on the destination device whose partition label (not filesystem label) matches the specified glob pattern. Multiple patterns can be specified in multiple options, or in a single option separated by commas.

Saved partitions will be renumbered if necessary. If partitions overlap with the install image, or installation fails for any other reason, the specified partitions will still be preserved. 🫶

• --save-partindex <id> — Save partitions with this number or range 🔢 Preserve any existing partitions on the destination device whose partition number matches the specified value or range. Ranges can be bounded on both ends ("5-7", inclusive) or one end ("5-" or "-7"). Multiple numbers or ranges can be specified in multiple options, or in a single option separated by commas.

Saved partitions will be renumbered if necessary. If partitions overlap with the install image, or installation fails for any other reason, the specified partitions will still be preserved. 🫶

• -h, --help — Print help (see a summary with -h) 🙋 (yes, the summary is what you get with the short flag, iykyk)
• -V, --version — Print version 🔖
• [DEST_DEVICE] — Destination device 💾 Path to the device node for the destination disk. The beginning of the device will be overwritten without further confirmation.

⚠️ bestie, read that last line again. The beginning of the device will be overwritten without further confirmation. no take-backs, no undo button, no "wait actually". 💀

---

🚀 ADVANCED OPTIONS 🚀

• --offline — Force offline installation 📴
• --insecure — Allow unsigned image 🔓 Allow the signature to be absent. Does not allow an existing signature to be invalid.
• --insecure-ignition — Allow Ignition URL without HTTPS or hash 🙈
• --stream-base-url <URL> — Base URL for CoreOS stream metadata 🌍 Override the base URL for fetching CoreOS stream metadata. The default is "https://builds.coreos.fedoraproject.org/streams/".
• --preserve-on-error — Don't clear partition table on error 🛑 If installation fails, coreos-installer normally clears the destination's partition table to prevent booting from invalid boot media. Skip clearing the partition table as a debugging aid.
• --fetch-retries <N> [default: 0] — Fetch retries, or "infinite" 🔁 Number of times to retry network fetches, or the string "infinite" to retry indefinitely.
• --secure-ipl — Enable IBM Secure IPL 🛡️

---

🌟 VERSION 🌟

v0.27.0

---

and that's a wrap, bestie 🎀 you just read the whole thing, which is main character energy fr fr. this page came to you from coreos-installer 0.27.0, living in the coreos-installer(8) manual — go forth and install some CoreOS, but maybe double-check your DEST_DEVICE first 🫶💜