1coreos-installer(8) System Manager's Manual coreos-installer(8)
2
6 coreos-installer-install - Install Fedora CoreOS or RHEL CoreOS
7
9 coreos-installer-install [-c|--config-file] [-s|--stream] [-u|--im‐
10 age-url] [-f|--image-file] [-i|--ignition-file] [-I|--ignition-url]
11 [--ignition-hash] [-a|--architecture] [-p|--platform] [--console]
12 [--append-karg] [--delete-karg] [-n|--copy-network] [--network-dir]
13 [--save-partlabel] [--save-partindex] [--offline] [--insecure] [--inse‐
14 cure-ignition] [--stream-base-url] [--preserve-on-error] [--fetch-re‐
15 tries] [-h|--help] [-V|--version] [DEST_DEVICE]
16
18 Install Fedora CoreOS or RHEL CoreOS
19
21 -c, --config-file=path
22 YAML config file with install options
23 Load additional config options from the specified YAML config
25 file. Later config files override earlier ones, and command-line
26 options override config files.
27 Config file keys are long option names without the leading "--".
29 Values are strings for non-repeatable options, arrays of strings
30 for repeatable options, and "true" for flags. The destination
31 device can be specified with the "dest-device" key.
32 -s, --stream=name
34 Fedora CoreOS stream
35 The name of the Fedora CoreOS stream to install, such as "sta‐
37 ble", "testing", or "next".
38 -u, --image-url=URL
40 Manually specify the image URL
41 coreos-installer appends ".sig" to find the GPG signature for
43 the image, which must exist and be valid. A missing signature
44 can be ignored with --insecure.
45 -f, --image-file=path
47 Manually specify a local image file
48 coreos-installer appends ".sig" to find the GPG signature for
50 the image, which must exist and be valid. A missing signature
51 can be ignored with --insecure.
52 -i, --ignition-file=path
54 Embed an Ignition config from a file
55 Embed the specified Ignition config in the installed system.
57 -I, --ignition-url=URL
59 Embed an Ignition config from a URL
60 Immediately fetch the Ignition config from the URL and embed it
62 in the installed system.
63 --ignition-hash=digest
65 Digest (type-value) of the Ignition config
66 Verify that the Ignition config matches the specified digest,
68 formatted as <type>-<hexvalue>. <type> can be sha256 or sha512.
69 -a, --architecture=name [default: x86_64]
71 Target CPU architecture
72 Create an install disk for a different CPU architecture than the
74 host.
75 -p, --platform=name
77 Override the Ignition platform ID
78 Install a system that will run on the specified cloud or virtu‐
80 alization platform, such as "vmware".
81 --console=spec
83 Kernel and bootloader console
84 Set the kernel and bootloader console, using the same syntax as
86 the parameter to the "console=" kernel argument.
87 --append-karg=arg
89 Append default kernel arg
90 Add a kernel argument to the installed system.
92 --delete-karg=arg
94 Delete default kernel arg
95 Delete a default kernel argument from the installed system.
97 -n, --copy-network
99 Copy network config from install environment
100 Copy NetworkManager keyfiles from the install environment to the
102 installed system.
103 --network-dir=path
105 Override NetworkManager keyfile dir for -n
106 Specify the path to NetworkManager keyfiles to be copied with
108 --copy-network.
109 [default: /etc/NetworkManager/system-connections/]
111 --save-partlabel=lx
113 Save partitions with this label glob
114 Preserve any existing partitions on the destination device whose
116 partition label (not filesystem label) matches the specified
117 glob pattern. Multiple patterns can be specified in multiple
118 options, or in a single option separated by commas.
119 Saved partitions will be renumbered if necessary. If partitions
121 overlap with the install image, or installation fails for any
122 other reason, the specified partitions will still be preserved.
123 --save-partindex=id
125 Save partitions with this number or range
126 Preserve any existing partitions on the destination device whose
128 partition number matches the specified value or range. Ranges
129 can be bounded on both ends ("5-7", inclusive) or one end ("5-"
130 or "-7"). Multiple numbers or ranges can be specified in multi‐
131 ple options, or in a single option separated by commas.
132 Saved partitions will be renumbered if necessary. If partitions
134 overlap with the install image, or installation fails for any
135 other reason, the specified partitions will still be preserved.
136 --offline
138 Force offline installation
139 --insecure
141 Allow unsigned image
142 Allow the signature to be absent. Does not allow an existing
144 signature to be invalid.
145 --insecure-ignition
147 Allow Ignition URL without HTTPS or hash
148 --stream-base-url=URL
150 Base URL for CoreOS stream metadata
151 Override the base URL for fetching CoreOS stream metadata. The
153 default is "https://builds.coreos.fedoraproject.org/streams/".
154 --preserve-on-error
156 Don't clear partition table on error
157 If installation fails, coreos-installer normally clears the des‐
159 tination's partition table to prevent booting from invalid boot
160 media. Skip clearing the partition table as a debugging aid.
161 --fetch-retries=N [default: 0]
163 Fetch retries, or "infinite"
164 Number of times to retry network fetches, or the string "infi‐
166 nite" to retry indefinitely.
167 -h, --help
169 Print help (see a summary with '-h')
170 -V, --version
172 Print version
173 [DEST_DEVICE]
175 Destination device
176 Path to the device node for the destination disk. The beginning
178 of the device will be overwritten without further confirmation.
179
181 v0.18.0
182 coreos-installer 0.18.0 coreos-installer(8)