Fedora sobre Raspberry Pi

Flo H, jtagcat, El Equipo Documental de Fedora Versión F42 Last review: 2025-06-24
El Raspberry Pi es un ARM de tarjeta de crédito dependiente de tamaño basado en computador de tarjeta de junta (SBC). Esta documentación describe como ser iniciado

Las series Raspberry Pi 3, 4 y Zero 2W son oficialmente compatibles, y la compatibilidad con la serie 3 se presentará en Fedora 27 y soporte para el 4 y Zero 2W que se están introduciendo en Fedora 37. Esto incluye gráficos acelerados por hardware, para los cuales anteriormente faltaba soporte OSS.

Sin embargo, Fedora decidió cortar mantenimiento para (32-bit) armv7 / armhfp en Fedora 37, por lo tanto las series Raspberry Pi 1, 2B, y Zero no son mantenidos por más tiempo.

La Raspberry Pi 5 aún no cuenta con soporte oficial.

Al final del documento encontrará una sección de Preguntas Más Frecuentes (P+F) sobre lo que se admite y lo que no.

Requisitos previos

  • Una Raspberry Pi compatible (placas compatibles).

  • Un suministro de energía (detalla en raspberrypi.org).

    • Cero 2 W: 2 Amps

    • 3B y 3B+: 2'5 Amps

    • 4B: 3.0 Amps

  • Monitor compatible HDMI o TV.

    • Un adaptador/cable Micro-HDMI a HDMI para el Raspberry Pi 4B.

    • Un adaptador/cable Mini-HDMI a HDMI para el Raspberry Pi Zero 2W.

  • Un teclado USB y un ratón USB.

    • Un adaptador Micro USB a USB-A, posiblemente con un enchufe USB, para el Raspberry Pi Zero 2W, como tener soloo un único puerto Micro USB para datos.

  • Si utiliza una tarjeta SD:

    • Un lector de tarjeta microSD.

    • Una tarjeta microSD (16 GB o mayor).

  • Si utiliza una unidad flash USB, con arranque USB:

    • Una unidad flash USB, preferiblemente USB 3.0 o más nuevo (16GB o mayor)

  • Un equipo ejecutando Microsoft Windos, macOS, o Linux.

  • Una imagen aarch64 de ARM en Fedora, tal como Workstation o Server, desde: https://fedoraproject.org/.

El procedimiento para instalar Fedora ARM en un microSD en preparación para emplear Fedora en un Raspberry Pi depende en su sistema operativo de su equipo (Microsoft Windows, macOS, o Linux).

Para instalación en Edición de Servidor Fedora consulte ARM Single Board Computer (SBC) Installation y Special: Single Board Computers.

Para IoT Edition consulte Reference Platforms

Instalar Fedora en un Raspberry Pi utilizando el instalador ARM de Fedora

Este procedimiento muestra a los usuarios de Fedora como añadir Fedora ARM a un microSD a utilizar con un Raspberry Pi utilizando el instalador de Fedora ARM.

Requisitorio

  • Un Raspberry Pi mantenido

  • Una tarjeta microSD (16 GB o mayor).

  • Un equipo ejecutando Fedora 28 o posterior.

  • Lector de tarjeta SD.

  • A Fedora ARM aarch64 image, such as Workstation or Server, from: https://fedoraproject.org/

Procedimiento

  1. Descargar una imagen Fedora ARM desde el sitio web de Fedora

  2. Check the integrity of the download curl https://getfedora.org/static/fedora.gpg | gpg --import gpg --verify-files *-CHECKSUM sha256sum -c *-CHECKSUM

  3. Instale el arm-image-installer:

    $ sudo dnf install -y arm-image-installer

  4. Como usuario root, escriba la imagen ARM de Fedora en la tarjeta microSD:

    $ sudo arm-image-installer \
--image=</path/to/fedora_image> \
--target=<RPi_Version> \
--media=/dev/__<sd_card_device> \
--resizefs

    Donde:

    • The </path/to/fedora_image> has the format Fedora-<spin><fedora_version>.aarch64.raw.xz.

      • For example: /home/user/Downloads/Fedora-Server-38-1.6.raw.xz.

    • <RPi_Version> is:

      • rpi2 para un Raspberry Pi 2.

      • rpi3 para un Raspberry Pi 3.

    • /dev/<sd_card_device> es la tarjeta microSD del 'dispositivo' en su sistema, tal como /dev/sdX o /dev/mmcblkX. El comando lsblk puede ayudarle a identificar su tarjeta micro-SD.

    • --resizefs: Cambiar el tamaño del sistema de archivos para que ocupe toda la tarjeta SD

      • Para ver las opciones de uso de arm-image-installer, ejecute:

        $ arm-image-installer --help

      • Para alistar las placas admitidas compruebe el archivo SUPPORTED-BOARDS.

        $ cat /usr/share/doc/arm-image-installer/SUPPORTED-BOARDS

Su tarjeta microSD está preparado para utilizarse con su Raspberry Pi.

Pasos Siguientes

For information on starting and configuring Fedora on Raspberry Pi, see: Booting Fedora on a Raspberry Pi for the first time.

Recursos Adicionales

Instalar Fedora en un Rasperry Pi para usuarios Linux

Este procedimiento muestra a usuarios de Linux como añadir Fedora ARM a un microSD para utilizar con un Raspberry Pi.

Requisitorio

  • Un Raspberry Pi mantenido

  • Una tarjeta microSD (16 GB o mayor).

  • Una máquina ejecutando Linux.

  • Acceso de usuario root (a través de su o sudo).

  • Lector de tarjeta SD.

  • Una imagen aarch64 de ARM en Fedora, tal como Workstation o Server, desde: https://fedoraproject.org/.

Procedimiento

  1. Descargue una imagen de Fedroa ARM desde el sitio web de Fedora.

  2. Ejecuta el comando siguiente para extraer la imagen .raw y escriba la imagen a su tarjeta microSD:

    El lugar de su tarjeta microSD será /dev/sdX o /dev/mmcblkX dependiendo de su hardware del equipo. 
    $ xzcat Fedora-IMAGE-NAME.aarch64.raw.xz | sudo dd status=progress bs=4M of=/dev/XXX

  3. Para re-dimensionar la partición principal, ejecute parted y seleccione el dispositivo.

    (parted) select /dev/sdX

  4. Inspeccione la cantidad de espacio no asignado en el final y re-dimensione la partición raíz.

    (parted) print free
(parted) resizepart <número_partición> <tamaño_destino>

  5. Re-dimensione el volumen físico de LVM tal que tome todo espacio disponible. Para que esto funcione debe desactivar cualquier volumen lógico dentro.

    # pvresize /dev/sdaX

  6. Entonces extienda el volumen lógico que corresponda al directorio raíz (/dev/fedora_fedora/root en este ejemplo).

    # lvextend -l +100%FREE /dev/fedora_fedora/root

  7. Finalmente, re-dimensione el sistema de archivos XFS en el volumen lógico (/dev/mapper/fedora_fedora-root dentro de este ejemplo).

    # xfs_growfs -d /dev/mapper/fedora_fedora-root

  8. Alternativamente, puede utilizar gparted para re-dimensionar la Partición Raíz en el microSD:

    $ gparted /dev/XXX

    Para información sobre utilizar re-dimensionado con gparted, consulte: Editor de Partición GNOME: Manual de GParted - Re-dimensionar una Partición.

    La partición raíz es reducida para el tamaño más pequeño posible para asegurar una descarga pequeña. Actualmente necesita redimensionarlo manualmente. Idealmente quisiéramos que suceda automáticamente (proyecto ideal comunitario importante).

Su tarjeta microSD está preparado para utilizarse con su Raspberry Pi.

Next steps

For information on starting and configuring Fedora on Raspberry Pi, see: Booting Fedora on a Raspberry Pi for the first time.

Recursos Adicionales

Installing Fedora on a Raspberry Pi for Microsoft Windows users

This procedure shows Microsoft Windows users how to add Fedora ARM to a microSD for use with a Raspberry Pi.

Requisitorio

  • Un Raspberry Pi mantenido

  • Una tarjeta microSD (16 GB o mayor).

  • A computer running Microsoft Windows.

  • Lector de tarjeta SD.

  • Una imagen aarch64 de ARM en Fedora, tal como Workstation o Server, desde: https://fedoraproject.org/.

  • File-decompression software (such as 7zip).

Procedimiento

  1. Descargue una imagen de Fedroa ARM desde el sitio web de Fedora.

  2. Extract the .raw file from the Fedora ARM image using file-decompression software (such as 7zip).

    Por ejemplo:

    > "C:\Program Files\7-Zip\7z.exe" x -y "C:\Users\admin\Downloads\Fedora-Server-38-1.6.aarch64.raw.xz"

  3. Follow the instructions provided by the Raspberry Pi foundation for writing an image to a microSD card from Microsoft Windows: Raspberry Pi Foundation: Installing operating system images using Windows.

    Las extensiones .img y .raw son utilizadas intercambiamente para archivo RAW (sin formato). Donde las instrucciones indican un archivo de entrada con la extensión .img, utilice la imagen '.raw' de Fedora ARM.

Su tarjeta microSD está preparado para utilizarse con su Raspberry Pi.

Pasos Siguientes

For information on starting and configuring Fedora on Raspberry Pi, see: Booting Fedora on a Raspberry Pi for the first time.

Recursos Adicionales

Instalar Fedora en un Raspberry Pi para usuarios de macOS

Este procedimiento muestra a los usuarios de macOS como añadir Fedora ARM s un microSD para utilizar con un Raspberry Pi.

Requisitorio
Procedimiento

  1. Download a Fedora ARM image from the Fedora website.

  2. Extrae el archivo .raw desde la imagen Fedora ARM utilizando software de descompresión de archivo (tal como The Unarchiver)

    Por ejemplo:

    $ unrar Fedora-Server-38-1.6.aarch64.raw.xz

  3. Siga las instrucciones proporcionadas por la fundación de Raspberry Pi para escribir una imagen a un cartucho microSD desde macOS: Raspberry Pi Foundation: Installing operating system images on Mac OS.

    Las extensiones .img y .raw son utilizadas intercambiamente para archivo RAW (sin formato). Donde las instrucciones indican un archivo de entrada con la extensión .img, utilice la imagen '.raw' de Fedora ARM.

Su tarjeta microSD está preparado para utilizarse con su Raspberry Pi.

Pasos Siguientes

For information on starting and configuring Fedora on Raspberry Pi, see: Booting Fedora on a Raspberry Pi for the first time..

Recursos Adicionales

Arrancando Fedora sobre una Raspberry Pi por primera vez

Follow these steps to boot Fedora ARM on your Raspberry Pi. If your MicroSD card does not have enough room, you need to resize the main partition after the initial setup. See Redimensione la partición principal de la tarjeta microSD tras configurar (si se requiere).

Requisitorio

  • Raspberry Pi 3-series, 4-series, or Zero 2W.

  • A power supply (details here).

    • Recommended 2.5 Amps, Micro USB, for Raspberry Pi 3 Model B and B+.

    • Recommended 3 Amps, USB-C, for the Raspberry Pi 4 Model B.

    • Recommended 2 Amps, Micro USB, for the Raspberry Pi Zero 2W.

  • Monitor compatible HDMI o TV.

    • Un adaptador/cable Micro-HDMI a HDMI para el Raspberry Pi 4B.

    • Un adaptador/cable Mini-HDMI a HDMI para el Raspberry Pi Zero 2W.

  • Un teclado USB y un ratón USB.

    • Un adaptador Micro USB a USB-A, posiblemente con un enchufe USB, para el Raspberry Pi Zero 2W, como tener soloo un único puerto Micro USB para datos.

  • The MicroSD card with Fedora imaged to it.

Procedimiento

  1. Introduzca la tarjeta SD en el Raspberry Pi.

  2. Connect a keyboard, mouse, monitor, and optionally network cable.

  3. Enchufe el Raspberry Pi a la fuente de energía. El «Asistente de configuración inicial» aparecería tras la carga de Fedora.

  4. Siga al asistente para poner su idioma, zona horaria y para crear usuarios.

Es sistema exhibe una solicitud de acceso u obtener guía de inicio (dependiendo de su Escritorio/SPIN).

Redimensione la partición principal de la tarjeta microSD tras configurar (si se requiere)

Siga estos pasos para redimensionar las particiones para Fedora ARM en Raspberry Pi:

  1. Ampliar la partición 4º (este ejemplo emplea mmcblk0).

    $ growpart /dev/mmcblk0p4

  2. Redimensione la partición raíz para la imagen del servidor (lo cual utiliza xfs).

    $ xfs_growfs -d /
Recursos Adicionales

Fedora en Raspberry Pi: Preguntas Más Frecuentes

Cuestiones preguntadas frecuentemente relativas con que está mantenido.

¿Por qué aparece una imagen de arcoíris cuando intento encender mi Raspberry Pi?

The rainbow display will appear for a second at the start of the boot process when the GPU firmware loads. However, if it persists, there is likely a problem preventing the Pi from booting.

Las causas comunes de la aparición del arcoíris incluyen:

¿Qué entornos de escritorio son compatibles?

Todos los escritorios que vienen con Fedora deberían funcionar, y los gráficos 2D y 3D funcionan de inmediato. Hay un controlador de código abierto totalmente acelerado para la GPU Video Core IV.

¿Habrá más mejoras en el soporte de hardware?

Sí. Las nuevas mejoras se entregarán mediante el mecanismo estándar de actualizaciones de Fedora. Las funciones importantes nuevas serán anunciadas en la Revista Fedora o en el Planeta Fedora.

What about support for the Raspberry Pi Models A/A+, B/B+ (generation 1), 2, Zero/ZeroW, and Compute Module (generation 1)?

Estos modelos de Raspberry Pi no están ya mantenidos.

Fedora is not supported on ARMv6 or ARMv7 processors. There’s been a number of attempts to support these over the years. The current best effort for ARMv6 is Pignus based on Fedora 23. More information can be found at the Pignus site. As ARMv7 support was retired with Fedora 37, the best option for the Raspberry Pi 2 is likely to use Fedora 36.

Fedora SÍ admite el Compute Module 3 basado en el mismo SoC que Raspberry Pi 3, pero como la anterior generación de Compute Modules se basan en la arquitectura ARMv6, no son mantenidos.

¿Qué dispositivos USB son compatibles con Raspberry Pi?

Most USB2 and USB3 compatible devices that are supported in Fedora on other devices. There are some limitations to the USB bus of the Raspberry Pi hardware prior to the Raspberry Pi 4 as documented here.

Is the onboard Wi-Fi supported on the Raspberry Pi 3, 4, and Zero 2W?

Wifi on the Raspberry Pi 3-series, 4-series, and Zero 2W devices works out of the box with all supported versions of Fedora.

Using Wi-Fi on CLI

To use Wi-Fi on minimal and server images you can configure the device using command line:

  • To list available networks:

    $ nmcli device wifi list

  • To connect to a network:

    nmcli device wifi connect $SSID --ask

    Where: $SSID is the network identifier (or name).

Is the onboard Bluetooth supported on the Raspberry Pi 3, 4, and Zero 2W?

Bluetooth works and is stable. The device sometimes has a generic bluetooth address but should work without any configuration.

Does sound work?

HDMI audio output is included with Fedora, however, the analog port is not yet supported. Audio output using a USB audio interface should work.

Does the add-on camera work?

Not at this time. There is still ongoing work to support this upstream and to add the appropriated media acceleration support.

Does accelerated media decode work?

No. The upstream kernel does not support the kernel subsystems required for accelerated media decoding.

Does HDMI-CEC work?

Yes. Yes. It’s supported using the new upstream CEC support. There’s a /dev/cec0 character device, it can be accessed using any application that supports the IR remote using the rc-cec keymap in the v4l-utils package, there’s also a cec-ctl utility for use on the command line.

Is the Raspberry Pi Touch Display supported?

El desarrollo de la pantalla táctil oficial de Raspberry Pi está en curso en el servidor de desarrollo y se proporciona soporte inicial en el kernel 4.10, consulte: GitHub: raspberrypi/linux issues - 7" LCD touchscreen not supported. Fedora revisará pronto las piezas ausentes para obtener soporte. El controlador de la pantalla táctil aún no se ha publicado en el servidor de desarrollo. Actualmente no se prevé compatibilidad con otras pantallas.

Is the composite TV out supported?

The composite TV out is not currently supported in a stable Fedora release but the core support is in the 4.10 kernel. There is some missing enabling patches which will be added to the Fedora kernel soon.

¿Son los HAT de expansión admitidos?

Las expansión de HAT no están mantenidas actualmente.

La respuesta larga es un montón más complejo. Mucho de los interfaces de hardware que son expuestos por el conector HAT de 40 pinchos son admitidos con controladores trasladados por Fedora.

Los controladores para el hardware de muchos de los HAT comunes también están habilitados y soportados en Fedora. El principal método para soportar las placas complementarias HAT requiere el uso de superposiciones de árbol de dispositivos. El kernel y el gestor de arranque u-boot 2016.09 permiten la carga manual de superposiciones. Actualmente no existe consenso sobre cómo cargar automáticamente estas superposiciones mediante un «administrador de superposiciones» (también conocido como Cape Manager y con muchos otros nombres) leyendo el ID de la EEPROM y cargando automáticamente la superposición correspondiente.

There’s also no consensus on the extensions to the dtc (Device Tree Compiler) to build the binary blob overlays, and no consensus of the exact format of the overlay file. There is now a group of people working to resolve this issue which enable Fedora to better support HATs (Raspberry Pi), Capes (BeagleBone), DIPs (C.H.I.P) and Mezzanine (96boards) before long.

The first focus HAT to support will be the official Raspberry Pi Sense HAT. This will be documented using the manual process to build and load the overlay to provide access to the onboard devices as a means of demonstrating how this process works for those wishing to use this manual method in the interim. The link to this documentation will be added here once that is complete.

El uso de config.txt

El archivo config.txt solo se usa para la configuración básica por el momento. Debido al uso del controlador de GPU vc4 de código abierto, la mayor parte de la configuración de video se realiza mediante Linux.

The configuration of HATs using config.txt is unsupported but is being actively developed.

Are Device Tree Overlays supported?

There’s basic support for overlays in u-boot and the Linux kernel but an overlay manager is not supported upstream.

Is GPIO supported?

GPIO is supported with the use of libgpiod and associated bindings and utilities.

RPI.GPIO is not currently supported.

¿Es compatible con SPI?

Sí, se admite SPI básico.

¿Es compatible con I2C?

Sí, se admite I2C básico.

¿Hay soporte para Raspberry Pi 3 aarch64?

¡Sí! Puedes descargar las imágenes de disco aarch64 para Raspberry Pi 3 desde el enlace: https://archive.fedoraproject.org/pub/fedora-secondary/releases/ [aquí].

How do I use a serial console?

The serial console is disabled by default on the Raspberry Pi 2 and 3 because it requires the device to run at significantly slower speeds.

To wire up the USB to TTL adapter follow this guide from Adafruit. You’ll need a 3.3 volt USB to TTL Serial Cable like this one from Adafruit.

To enable the serial console follow the specific steps for the Raspberry Pi 2 or 3 as they both differ slightly:

Raspberry Pi 2:

  1. Insert the microSD card into a PC

  2. On the VFAT partition edit the config.txt file and uncomment the enable_uart line:

    $ enable_uart=1

  3. On the boot partition edit the extlinux/extlinux.conf file adding console=tty0 console=ttyAMA0,115200 to the end of the append line so it looks similar to:

    $ append ro root=UUID="LARGE UUID STRING OF TEXT" console=tty0 console=ttyAMA0,115200

  4. Safely unmount the microSD card

  5. Insert microSD into Raspberry Pi, connect serial console, power on

Raspberry Pi 3:

  1. Insert the microSD card into a PC

  2. On the VFAT partition edit the config.txt file and uncomment the enable_uart line:

    $ enable_uart=1

  3. En la partición de arranque, edite el archivo extlinux/extlinux.conf agregando: console=tty0 console=ttyS0,115200 al final de la línea agregada para que se vea similar a:

    $ append ro root=UUID="LARGE UUID STRING OF TEXT" console=tty0 console=ttyS0,115200

  4. Safely unmount the microSD card

  5. Insert microSD into Raspberry Pi, connect serial console, power on

Recursos Adicionales

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