Requisitos previos para los tutoriales

Los siguientes tutoriales se centran en ayudarte a empezar a usar Fedora CoreOS, aprendiendo a configurar (o aprovisionar) automáticamente una instancia en el primer arranque. Cada tutorial se basa en el anterior, por lo que se recomienda seguirlos secuencialmente.

Si no sabe qué es Fedora CoreOS, puede consultar P+F para obtener más información.

Si necesita ayuda o tiene alguna pregunta mientras sigue estos tutoriales, únase al enlace: Sala Matrix o únase a nuestro foro de discusión: https://discussion.fedoraproject.org/tag/coreos. Si encuentra algún problema con el tutorial, infórmelo en el seguidor de problemas de fedora-coreos-docs.

Debes comenzar con las instrucciones de configuración de esta página, ya que deben completarse primero para poder seguir los tutoriales.

Virtualización con libvirt

Estos tutoriales están diseñados para un entorno Linux con una configuración de libvirt funcional y compatibilidad con virtualización de hardware mediante KVM. Sin embargo, no hay información específica sobre el entorno libvirt en esos tutoriales, por lo que puede probar las mismas configuraciones en cualquier plataforma donde tengas acceso a la consola (o puedes pasar directamente al tutorial de acceso SSH para obtener acceso remoto).

For instructions to set up libvirt and KVM you may refer to the Getting started with virtualization guide from Fedora. Although this setup guide is focused on Fedora, the tutorials should work on any distribution with libvirt installed and running.

Local working directory

To keep all configuration files and Fedora CoreOS images in the same place, we will create a new directory to work from:

mkdir ~/coreos
cd ~/coreos

SSH public key

Some of the tutorials add an SSH public key to the instances to allow for SSH access as opposed to serial console access. Please place a public key in your current working directory under the filename ssh-key.pub. For example, for a RSA keypair the default location would be in ~/.ssh/id_rsa.pub:

cp ~/.ssh/id_rsa.pub ssh-key.pub

CoreOS tools

For the tutorials, we will need the following tools:

  • Butane: To generate Ignition configuration from Butane config files.

  • coreos-installer: To download the latest Fedora CoreOS QCOW2 image.

  • ignition-validate: To validate Ignition configuration files.

Setup with podman or docker

All the tools required to work with Fedora CoreOS are available from containers hosted on quay.io:

podman pull quay.io/coreos/butane:release
podman pull quay.io/coreos/coreos-installer:release
podman pull quay.io/coreos/ignition-validate:release

To make it simpler to type, you may add the following aliases to your shell configuration:

alias butane='podman run --rm --interactive         \
              --security-opt label=disable          \
              --volume "${PWD}:/pwd" --workdir /pwd \
              quay.io/coreos/butane:release'

alias coreos-installer='podman run --pull=always              \
                        --rm --interactive                    \
                        --security-opt label=disable          \
                        --volume "${PWD}:/pwd" --workdir /pwd \
                        quay.io/coreos/coreos-installer:release'

alias ignition-validate='podman run --rm --interactive         \
                         --security-opt label=disable          \
                         --volume "${PWD}:/pwd" --workdir /pwd \
                         quay.io/coreos/ignition-validate:release'

You can then use coreos-installer to download the latest stable image with:

coreos-installer download -p qemu -f qcow2.xz --decompress

To make the tutorial simpler, you should rename the image that we have just downloaded to a shorter name:

mv fedora-coreos-43.20251120.3.0-qemu.x86_64.qcow2 fedora-coreos.qcow2

You are now ready to proceed with the first tutorial.

Installing via Fedora packages

All three tools (Butane, coreos-installer, and ignition-validate) are available as Fedora packages:

# Installing the tools
sudo dnf install -y butane coreos-installer ignition-validate

# Downloading the latest Fedora CoreOS stable QCOW2 image
coreos-installer download -p qemu -f qcow2.xz --decompress

To make the tutorial simpler, you should rename the image that we have just downloaded to a shorter name:

mv fedora-coreos-43.20251120.3.0-qemu.x86_64.qcow2 fedora-coreos.qcow2

You are now ready to proceed with the first tutorial.

Manual download

If none of the previous solutions work for you, you can still manually download Fedora CoreOS from fedoraproject.org with:

RELEASE="43.20251120.3.0"
curl -O https://builds.coreos.fedoraproject.org/prod/streams/stable/builds/${RELEASE}/x86_64/fedora-coreos-${RELEASE}-qemu.x86_64.qcow2.xz
curl -O https://builds.coreos.fedoraproject.org/prod/streams/stable/builds/${RELEASE}/x86_64/fedora-coreos-${RELEASE}-qemu.x86_64.qcow2.xz.sig

Once the archive has been downloaded, make sure to verify its integrity by following the instructions available by clicking on the Verify signature & SHA256 button. You will have to download the checksum file, the signature and Fedora GPG keys to verify your download:

curl https://fedoraproject.org/fedora.gpg | gpg --import
gpg --verify fedora-coreos-${RELEASE}-qemu.x86_64.qcow2.xz.sig

Una vez que haya verificado el archivador, puede extraerlo con:

unxz fedora-coreos-${RELEASE}-qemu.x86_64.qcow2.xz

To make the tutorial simpler, you should rename the image that we have just downloaded to a shorter name:

mv fedora-coreos-43.20251120.3.0-qemu.x86_64.qcow2 fedora-coreos.qcow2

You should then download the latest Butane and ignition-validate releases from GitHub:

# Butane
curl -OL https://github.com/coreos/butane/releases/download/v0.25.1/butane-x86_64-unknown-linux-gnu
curl -OL https://github.com/coreos/butane/releases/download/v0.25.1/butane-x86_64-unknown-linux-gnu.asc
gpg --verify butane-x86_64-unknown-linux-gnu.asc
mv butane-x86_64-unknown-linux-gnu butane
chmod a+x butane

# ignition-validate
curl -OL https://github.com/coreos/ignition/releases/download/v2.24.0/ignition-validate-x86_64-linux
curl -OL https://github.com/coreos/ignition/releases/download/v2.24.0/ignition-validate-x86_64-linux.asc
gpg --verify ignition-validate-x86_64-linux.asc
mv ignition-validate-x86_64-linux ignition-validate
chmod a+x ignition-validate

You may then set up aliases for butane and ignition-validate:

alias butane="${PWD}/butane"
alias ignition-validate="${PWD}/ignition-validate"

Or move those commands to a folder in your $PATH, for example:

mv butane ignition-validate "${HOME}/.local/bin/"
# Or
mv butane ignition-validate "${HOME}/bin"

You are now ready to proceed with the first tutorial.

Want to help? Learn how to contribute to Fedora Docs ›