When you buy a Raspberry Pi, it may or may not be sold with an SD card. The SD card is important because this is where the Raspberry Pi keeps its operating system and is also where you will store your documents and programs.  

Even if your Pi came with an SD card with an operating system on, it is a good idea to update it to the latest version, as improvements and bug fixes are going in all the time. Since putting the operating system onto an SD card wipes everything else off the card, it is worth considering using a USB flash drive for your documents, so that when you install a new version of the operating system, you don't have the complication of copying them off somewhere safe before reformatting the SD card.

If your Pi did not come with an SD card then the minimum size you should get is 8GB, but buy a bigger SD card if you think you will need the space. (If you're planning to store media files or work with other SD card images on your Pi, you probably need a bigger card.)

This lesson shows you how to create an SD card for your Raspberry Pi.

To prepare an SD card for your computer, you will need:

A 'regular' computer with a built-in SD card reader, or an add-on USB SD card reader. The instructions here are for Windows and Mac. You can pick up a tiny microSD card reader/writer that is nice and fast and works with all USB ports at the Adafruit shop.

An SD card at least 8GB in capacity. You can pick one up that is tested and guaranteed to work with the Raspberry Pi at the Adafruit shop. (If buying elsewhere, remember that for the Pi 2,  3 and Zero you'll need microSD.)

What is Raspberry Pi Imager?

Once you have your Pi and SD card, the next step is to install an operating system onto the SD card. Previously this was a bit difficult, especially for beginners, because of varying main operating systems (macOS, Windows, Ubuntu, etc.) and their different methods of accessing the SD card.

Now there's a new tool called Raspberry Pi Imager that does all the heavy lifting for you.

It's as simple as choosing the desired operating system, selecting the SD card, and hitting WRITE.

Download Raspberry Pi Imager 

Head here, then download the application for your operating system by clicking the corresponding link.

Raspberry Pi Imager is supported by macOS, Windows and Ubuntu.

Using the software

Choose your OS and place on SD card

Once the software is downloaded, open up the application.

First, choose which operating system you'd like to put on the SD card. Most will go with Raspbian but you have quite a bit of options here. For more on this topic, see Choose your operating system below.

Next, insert your SD card into your computer and select it inside the application.

Power user trick: press Control+Shift+X (Windows) or ⌘+Shift+X (Mac) to bring up the Advanced Options dialog, where you can configure essentials like WiFi before the card is even written, rather than having to change all this on the Pi later.

When you have your software and sd card selected, go ahead and hit "WRITE". This will place the selected OS onto the SD card.

Depending on the size of the operating system you choose, this may take some time (10-15 min)

Finished!

Choose your operating system

There are a bewildering number of operating systems that you can install on your Raspberry Pi. If you are a beginner, you'll probably want to stick with one of the Linux distributions.

Choose your distribution

Having decided you want to install Linux, that is not the end of the story. You now have to decide which distribution or 'distro' of Linux you want to install. Being an Open Source operating system, anyone can take one of the existing distributions an add things to it or configure it in a certain way before packaging it up as another distribution option for anyone to use. This is how the most common Raspberry Pi distribution, 'Raspbian', came into existence. The existing 'Debian' distribution was configured and kitted out with useful things like IDLE (a python-programming language development editor) and Scratch (a learn-to-program gaming system) to make it suitable for the Pi.

All of the Adafruit tutorials (and nearly every other tutorial online) will work with Raspbian, and nearly every Pi out there runs it.

Erasing an SD card

In addition to uploading a number of pre-configured OSes, with Imager, you can also ERASE an SD card.

Just select ERASE from the operating system list, the SD card you'd like to erase and hit WRITE.

Balena Etcher is the imager most people used before the Raspberry Pi Imager was written & released. It works very well and we think some people will continue to use it or perhaps already have it installed!

The operating system that will be installed onto the SD card must be downloaded from the Internet. This will usually be a zip file that then extracts to a file of type .img an image file. Whatever image file you download, the actual installation process is the same.

Choose your Operating System

There are a bewildering number of operating systems that you can install on your Raspberry Pi. If you are a beginner, you'll probably want to stick with one of the Linux distributions.

Choose your Distribution

Having decided you want to install Linux, that is not the end of the story. You now have to decide which distribution or 'distro' of Linux you want to install. Being an Open Source operating system, anyone can take one of the existing distributions an add things to it or configure it in a certain way before packaging it up as another distribution option for anyone to use. This is how the most common Raspberry Pi distribution, 'Raspbian', came into existence. The existing 'Debian' distribution was configured and kitted out with useful things like IDLE (a python-programming language development editor) and Scratch (a learn-to-program gaming system) to make it suitable for the Pi.

All of the Adafruit tutorials (and nearly every other tutorial online) will work with Raspbian, and nearly every Pi out there runs it.

Additionally, Adafruit offers a growing set of tools for working with Raspbian installations, such as the Adafruit Raspberry Pi Finder, a GUI for configuring your Pi over the network. The CircuitPython libraries can easily be installed on your Pi thanks to the adafruit-blinka package. 

Whatever distribution you're installing, you'll probably have a zip file that looks something like one of these:

...open the .zip and extract the .img to your desktop.

We really like using balenaEtcher for burning SD cards. Works great on any version of Windows, macOS and Linux. It will not over-write your backup disk drive, and can handle compressed images so you do not need to unzip them!

Step 1.

Download Etcher from: https://www.balena.io/etcher/

Step 2.

Run the downloaded app to install!

You can start immediately, doubleclick the Etcher desktop icon, or select it from the Start menu

Step 3.

Eject any external storage devices such as USB flash drives and backup hard disks. This makes it easier to identify the SD card. Then insert the SD card into the slot on your computer or into the reader.

Step 4.

Run the Etcher program

This will launch the following application.

Step 5.

Select the image file by clicking Select Image you can select a compressed file such as a .zip or .gz

Step 6.

Etcher will automatically try to detect the SD drive, check the size to make sure its the right one

Then click Flash!

Check that you have the right device, as it will be reformatted, and then click Install.

It will take a few minutes to install, but once the SD card is ready, you will see the following.

That's all there is to it. Your SD card is ready for use in your Raspberry Pi.

Faster writes

If you burn a lot of cards, speed it up by turning off Validate write on success

We really like using balenaEtcher for burning SD cards. Works great on Mac OS X 10.9 or later, won't over-write your backup disk drive, and can handle compressed images so you do not need to unzip them!

Mac OS Catalina Issues

If you are having issues running Etcher on the Catalina release of Mac OS, see the links below for more information and some suggested workarounds.

Most success has been reported by simply running Etcher from the command line using sudo:

sudo /Applications/balenaEtcher.app/Contents/MacOS/balenaEtcher

Step 1.

Download Etcher from https://www.balena.io/etcher/

Step 2.

Open the downloaded disk image and drag the balenaEtcher application to the Applications folder. You can then eject the disk image.

Step 3.

Eject any external storage devices such as USB flash drives and backup hard disks. This makes it easier to identify the SD card. Then insert the SD card into the slot on your computer or into the reader.

Step 4.

Run the Etcher application.

The first time you run Etcher you’ll be asked to confirm the download. Click “Open” to continue.

This will launch the Etcher application…

Step 5.

Select the SD card image file by clicking Select Image. You can choose a compressed SD image file such as a .zip or .gz or an uncompressed .img, it’s all good!

Step 6.

Etcher will automatically try to detect the SD drive. If you don’t have an SD card currently inserted, you’ll be prompted to connect one.

Check the disk size to make sure its the right one, that it’s not overwriting your main drive or anything nasty. 

Then click Flash! A-ah!

Etcher will work for a few minutes to “burn” the SD image to the card. You’ll see a progress bar as it works. This is about the time you’ll wish you’d splurged on a high-speed card.

Once the SD card is ready, you will see the following:

The card will be unmounted automatically, so you can pull it out now and use it in your Raspberry Pi.

Faster Writes

If you find yourself burning a lot of SD cards, you can speed things up by clicking the gear icon at the top-right, then turn off the “Validate write” option. I’ve written hundreds of cards and only had one fail validation.

If you plan to use multiple SD cards, it is not a bad idea to label the card, or for microSD cards label the little plastic case they usually come in.

Testing the card is easy - insert it into your Pi, then connect a keyboard to the USB port and a NTSC/PAL TV to the composite port or an HDMI monitor to the HDMI Port. Then power it by connecting a Micro USB cable to the Pi and powering it via a computer or a USB wall charger.

For Raspbian, you should see something like the following, an Adafruit/Raspberry logo in the top left, and a ton of text filling up the screen:


In the next tutorial, you will find out how to configure your Raspberry Pi the first time you boot it up.

This guide was first published on Dec 03, 2012. It was last updated on Mar 08, 2024.