== Installing Fedora on a Raspberry Pi for macOS users
// 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_.

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

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

._Prerequisites_

* A supported Raspberry Pi
* A microSD Card (16 GB or larger).
* A computer running macOS.
* SD card reader.
* A Fedora ARM image from: link:https://arm.fedoraproject.org/[].
* File-decompression software (such as link:https://theunarchiver.com/[The Unarchiver desktop application] or link:https://theunarchiver.com/command-line[The Unarchiver command-line tools]).

._Procedure_

. Download a Fedora ARM image from the  link:https://arm.fedoraproject.org/[Fedora ARM website].
+
. Extract the `.raw` file from the Fedora ARM image using file-decompression software (such as link:https://theunarchiver.com/[The Unarchiver])
+
For example:
+
[source,shell,subs="attributes"]
----
$ unar Fedora-Server-armhfp-{MAJOROSVER}-1.1-sda.raw.xz
----

. Follow the instructions provided by the Raspberry Pi foundation for writing an image to a microSD card from macOS: link:https://www.raspberrypi.org/documentation/installation/installing-images/mac.md[Raspberry Pi Foundation: Installing operating system images on Mac OS].
+
[NOTE]
====
The `.img` and `.raw` extensions are used interchangeably for RAW file. Where the instructions indicate an input file with the `.img` extension, use the Fedora ARM image '.raw'.
====

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 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]