== Installing Fedora on a Raspberry Pi using the Fedora ARM installer
// Start the title of a procedure module with a verb, such as Creating or Create. See also _Wording of headings_ in _The IBM Style Guide_.

:experimental:
include::{partialsdir}/attributes.adoc[]

This procedure shows Fedora users how to add Fedora ARM to a microSD for use with a Raspberry Pi using the Fedora ARM installer.

._Prerequisites_

* A supported Rasbperry Pi
* A microSD Card (16 GB or larger).
* A computer running Fedora 28 or newer.
* SD card reader.
* A Fedora ARM aarch64 Workstation or server image from:  link:https://fedoraproject.org/[]

._Procedure_

. Download a Fedora ARM image from the link:https://fedoraproject.org/[Fedora website]
+
. Install the `arm-image-installer`:
+
[source,shell,subs="attributes"]
----
$ dnf install -y arm-image-installer
----
+
. As the root user, write the Fedora ARM image to the microSD card:
+
[source,shell,subs="quotes,attributes"]
----
# arm-image-installer --image=__</path/to/fedora_image>__ --target=__<RPi_Version>__ --media=/dev/__<sd_card_device>__ --resizefs
----
+
Where:
+
* The `__</path/to/fedora_image>__` has the format `Fedora-__<spin>__-armhfp-__<fedora_version>__-sda.raw.xz`.
** For example: `/home/user/Downloads/Fedora-Server-armhfp-{MAJOROSVER}-1.1-sda.raw.xz`.
* `__<RPi_Version>__` is:
** `rpi2` for a Raspberry Pi 2.
** `rpi3` for a Raspberry Pi 3.
* `/dev/__<sd_card_device>__` is the microSD card 'device' on your system, such as `/dev/sdX` or `/dev/mmcblkX`. The `lsblk` command may help you identify your micro-SD card.
+
[NOTE]
====
* To see usage options for the `arm-image-installer`, run:
+
[source,shell,subs="attributes"]
----
$ arm-image-installer --help
----

* For list of supported boards please check SUPPORTED-BOARDS file.
+
[source,shell,subs="attributes"]
----
$ cat /usr/share/doc/arm-image-installer/SUPPORTED-BOARDS
----
====

Your microSD card is ready to be used with your Raspberry Pi.

ifeval::["{context}" == "rpi"]
._Next Steps_

For information on starting and configuring Fedora on Raspberry Pi, see: xref:booting-fedora-on-a-raspberry-pi-for-the-first-time_{context}[].
endif::[]

._Additional Resources_

* For information on using the Fedora ARM Installer, see: link:https://fedoraproject.org/wiki/Architectures/ARM/Installation[Fedora Wiki: Installing Fedora on your ARM device].
* For assistance or support, see:
** link:https://ask.fedoraproject.org/[Ask Fedora]
** link:https://lists.fedoraproject.org/admin/lists/arm%40lists.fedoraproject.org/[Fedora ARM mailing list]
** link:https://web.libera.chat/?channels=#fedora-arm[IRC via the #fedora-arm channel on Libera.Chat]