Zen

Source string Source string

92/10000 · 92

The string is read only.

English Actions
This guide provides instructions to install Fedora CoreOS to bare metal. Three options are available:
Installing from live ISO
Installing from PXE
Installing from the container
Prerequisite
Before installing FCOS, you must have an Ignition configuration file and host it somewhere (e.g. using `python3 -m http.server`). If you do not have one, see xref:producing-ign.adoc[Producing an Ignition File].
If you have servers with different types and/or number of hard drives, you must create a separate customized Ignition config for each machine (or machine class). A good model is to have the common parts of the configuration factored out into a separate Ignition configuration which can be merged into (via HTTP or inline) the per-machine custom config.
To install FCOS onto bare metal using the live ISO interactively, follow these steps:
Download the latest ISO image from the https://fedoraproject.org/coreos/download/?stream=stable#baremetal[download page] or with podman (see https://coreos.github.io/coreos-installer/cmd/download/[documentation] for options):
podman run --security-opt label=disable --pull=always --rm -v .:/data -w /data \
quay.io/coreos/coreos-installer:release download -s stable -p metal -f iso
Note this is just using `coreos-installer` as a tool to download the ISO.
You can boot the live ISO in either legacy BIOS or UEFI mode, regardless of what mode the OS will use once installed.
Burn the ISO to disk. On Linux and macOS, you can use `dd`. On Windows, you can use https://rufus.ie/[Rufus] in "DD Image" mode.
Boot it on the target system. The ISO is capable of bringing up a fully functioning FCOS system purely from memory (i.e. without using any disk storage). Once booted, you will have access to a bash command prompt.
You can now run `coreos-installer`:
sudo coreos-installer install /dev/sda \
--ignition-url https://example.com/example.ign
Once the installation is complete, you can reboot the system using `sudo reboot`. After rebooting, the first boot process begins. It is at this time that Ignition ingests the configuration file and provisions the system as specified.
For more advanced ISO installs, including automation, see below. For more about the live ISO image, see the xref:live-reference.adoc[live image reference].
Check out `coreos-installer install --help` for more options on how to install Fedora CoreOS.
Installing from the network
Booting the live PXE image requires at least 2 GiB of RAM with the `coreos.live.rootfs_url` kernel argument, and 4 GiB otherwise. You can install in either legacy boot (BIOS) mode or in UEFI mode, regardless of what mode the OS will use once installed.
To install from PXE, follow these steps:
Download an FCOS PXE kernel, initramfs, and rootfs image:
podman run --security-opt label=disable --pull=always --rm -v .:/data -w /data \
quay.io/coreos/coreos-installer:release download -f pxe
Follow this example `pxelinux.cfg` for booting the installer images with PXELINUX:
DEFAULT pxeboot
TIMEOUT 20
PROMPT 0
LABEL pxeboot
KERNEL fedora-coreos-{stable-version}-live-kernel-x86_64
APPEND initrd=fedora-coreos-{stable-version}-live-initramfs.x86_64.img,fedora-coreos-{stable-version}-live-rootfs.x86_64.img coreos.inst.install_dev=/dev/sda coreos.inst.ignition_url=http://192.168.1.101:8000/config.ign
IPAPPEND 2
For more details on how to use this information, see this https://dustymabe.com/2019/01/04/easy-pxe-boot-testing-with-only-http-using-ipxe-and-libvirt/[blog post] for testing a PXE installation via a local VM and `libvirt`. For other supported kernel command-line options, see the https://coreos.github.io/coreos-installer/getting-started/#kernel-command-line-options-for-coreos-installer-running-as-a-service[coreos-installer docs], but note that `coreos-installer pxe customize` (see below) is more flexible. For more about the live PXE image, see the xref:live-reference.adoc[live image reference].
Installing from iPXE
An iPXE-capable machine needs to be provided with a relevant Boot Script to fetch and load FCOS artifacts.
The example below shows how to load those directly from Fedora infrastructure. For performance and reliability reasons it is recommended to mirror them on the local infrastructure, and then tweak the `BASEURL` as needed.
#!ipxe

Loading…

User avatar None

Source string added

  1. fedora-docs-l10n/fedora-coreos
  2. master/pages/bare-metal
  3. English
sudo coreos-installer install /dev/sda \
--ignition-url https://example.com/example.ign
3 years ago
Browse all string changes

Things to check

Multiple failing checks

Following checks are failing:
Unchanged translation: Spanish, Portuguese (Brazil)

Reset

Glossary

English English
No related strings found in the glossary.

String information

Source string description
type: delimited block -
Flags
no-wrap, placeholders:r"`[\w.\/\-_=@&*:$●+~()\] ]*`", read-only
Source string location
./pages/bare-metal.adoc:37
String age
3 years ago
Last updated
11 months ago
Source string age
3 years ago
Translation file
pot/master/pages/bare-metal.pot, string 17