RasQberry Installation Overview

Below you can find the list of steps that are needed to write the RasQberry Two image to an SD card and use it in your Raspberry Pi version 4 or 5.

Download Options

Download Page

Visit rasqberry.org/latest/ to browse and download all available RasQberry images including stable, beta, and development builds.

Direct Download URLs

Use these URLs to always get the latest release for each stream:

These URLs automatically redirect to the latest image for each release stream.

GitHub Releases

All releases are also available on GitHub Releases.

JSON APIs

For automation and programmatic access:

Using Pi Imager with RasQberry Repository

One-click: Open in Raspberry Pi Imager (recommended)

If you already have Raspberry Pi Imager installed (version 2.0.3 or newer), just click this link — it opens Imager pre-loaded with the RasQberry images:

▶ Open in Raspberry Pi Imager

Imager shows a brief security confirmation, then the RasQberry images appear under Choose OS.

Don't have Raspberry Pi Imager yet? Download it here first (it's the shipped default on all platforms), then click the link above.

Manual: add the custom repository in Imager

If the one-click link doesn't launch Imager, add the repository by hand:

1. Open Raspberry Pi Imager.
2. Click App Options in the bottom-left corner of the window.
3. Under Content Repository, choose Use custom URL.
4. Paste: https://RasQberry.org/RQB-images.json
5. Click Apply & Restart. The RasQberry images appear under Choose OS.

A custom URL is remembered across app restarts (unlike a custom file, which must be re-selected each time).

About the RasQberry Image

The RasQberry image contains a desktop environment with quantum computing demos accessible via desktop icons and the raspi-config menu.

raspi-config Menu (access via sudo raspi-config):

Default credentials:

• Username: rasqberry
• Password: Qiskit1!
• SSH and VNC are enabled by default

Steps to write the RasQberry Image to your SD Card

! Warning: Ensure there is no important information stored on this SD Card before following these steps.

1. Download and install the Raspberry Pi Imager: https://www.raspberrypi.com/software/

2. Put a formatted SD into the SD card reader of your computer. If your computer does not have an SD Card reader slot, you can use a USB SD Card Reader.

3. Open the Raspberry Pi Imager with the following command in a terminal window. Depending on your OS the command will differ:

   Mac OS

   /Applications/Raspberry\ Pi\ Imager.app/Contents/MacOS/rpi-imager --repo https://rasqberry.org/RQB-images.json

   Copy

   Windows

   "C:\Program Files (x86)\Raspberry Pi Imager\rpi-imager.exe" --repo https://rasqberry.org/RQB-images.json

   Copy
   
   

4. Click Choose OS and select a RasQberry image:

   • RasQberry Two Beta - Pre-release with latest tested features
   • RasQberry Two Dev - Development builds (latest but may be unstable)

5. Click Choose Storage and select your SD Card.

6. Click Next.

7. When prompted about OS customization, select No - the RasQberry image is pre-configured and should be written without modifications.

8. Click Yes to erase all existing data and write the image to the SD card.

9. Wait for the writing and verification process to complete.

10. Insert the SD Card into your Raspberry Pi 4 or 5, connect power, and boot.