Installation

Topics

• Requirements
• SD Card Preparation
• Initial Boot
• Troubleshooting

---

Requirements

You'll definitely need:

• a Raspberry Pi board (all models are supported, but generations 3 and 4 are recommended)
• a micro SD card (the minimum required capacity is 2GB)
• a power supply unit capable of delivering enough current for your Pi and connected peripherals
• a laptop or desktop machine equipped with an SD card reader (running the OS of your preference)
• a properly configured local network

You may also need:

• a case for your Pi
• WiFi and/or Bluetooth USB adapters, if your Pi board does not come with WiFi/Bluetooth on-board adapter
• an Ethernet cable, if you plan to connect the Pi to your wired network
• an HDMI monitor and a keyboard, in case you must do some troubleshooting in the absence of a network connection
• various peripherals, such as sensors and GPIO expansion boards, that you may wish to use

SD Card Preparation

Download OS Image

All versions and variants of the OS images are available for download on the Releases page.

Choose the Latest release, unless you know what you're doing. At the end of the release notes, you'll find download links corresponding to all Raspberry Pi generations, of the following format:

qtoggleos-raspberrypi<generation>-<version>.img.xz

The missing generation refers to the first generation. It is important to choose the correct image for your board, otherwise it won't boot. The following table indicates model - generation correspondence:

Model	Generation
Raspberry Pi Model A	Generation 1
Raspberry Pi Model B	Generation 1
Raspberry Pi Model A+	Generation 1
Raspberry Pi Model B+	Generation 1
Raspberry Pi Compute Module	Generation 1
Raspberry Pi Zero	Generation 1
Raspberry Pi Zero W	Generation 1
Raspberry Pi 2 B	Generation 2
Raspberry Pi 3 B	Generation 3
Raspberry Pi 3 B+	Generation 3
Raspberry Pi 3 A	Generation 3
Raspberry Pi Compute Module 3	Generation 3
Raspberry Pi 4	Generation 4

Initial Boot

Troubleshooting