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:

StreamURLDescription
Stablerasqberry.org/latest/stableProduction-ready releases
Betarasqberry.org/latest/betaPre-release with latest features
Devrasqberry.org/latest/devDevelopment builds (unstable)

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:

EndpointDescription
RQB-images.jsonPi Imager format with latest stable/beta/dev images
RQB-images-all.jsonAll image versions from all branches (for development/testing)
RQB-releases.jsonRelease metadata with download URLs, file sizes, and checksums

Using Pi Imager with RasQberry Repository

Simplified Installation with Desktop Launcher

For the easiest experience, install a pre-configured Pi Imager launcher that automatically loads RasQberry images.

On macOS (one-line command):

curl -sSL https://rasqberry.org/install-rpi-imager-launcher.sh | bash

This creates a "Pi Imager for RasQberry" app on your Desktop with the RasQberry icon.

On Windows (PowerShell as Administrator):

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://rasqberry.org/install-rpi-imager-launcher.ps1'))

This creates a "Pi Imager for RasQberry" shortcut on your Desktop.

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):

Menu ItemDescription
Quantum DemosLED tests, Quantum Lights Out, Raspberry-Tie, Bloch Sphere, Fractals, IBM Tutorials, and more
Touch Mode SettingsEnable/disable touch screen mode
Update Env FileModify RasQberry environment variables
Software & Full Image UpdatesA/B boot management, GitHub branch updates
System InfoView RasQberry version information

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

    Windows

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

  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.

Edit this page on GitHub