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 Rasberry Pi version 4 or 5.

The future available releases of the RasQberry-Two will be stored in the release section from the Github repository “JanLahmann/RasQberry-pi-gen” (https://github.com/JanLahmann/RasQberry-pi-gen/tags). An image from this release section wil also be used in the custom repository configuration of the Pi-imager. You can find the decription of the pi-imager start with a custom repository incl. rasQberry-two the section below.

The RasQberry image contains a desktop environment that was adjusted for the rasqberry-two. Several demos can be found via the desktop menu to start right away with several Quantum Demos.

This image also contains the RasQberry-two menu structure from the repository https://github.com/JanLahmann/RasQberry-Two. In your raspi-config menu (open via command: sudo raspi-config) you can find based on this repositoy the following rasQberry menu entries.

One-Click Install Run standard RQB2 setup automatically System Update Update the system and create swapfile Initial Config Basic configurations (PATH, LOCALE, Python venv, etc) Qiskit Install Install latest version of Qiskit Quantum Demos Install Quantum Demos

Please note that currently, only the last menu option “install quantum demos” should be used. “one-click install” is not needed when using our RasQberry image (and it will not work).

! Note: The standard user is rasqberry with the pwd: “Qiskit1!” Currently, modifying the username is not supported - and will not work. We recommend to not change any settings in “Edit Settings” in the Raspberry Pi Imager (step 7 - 13 below). FYI: 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 the Choose OS button. Select the operating system RasQberry Two (64-bit)

   

   

   

5. Click Choose Storage and select the SD Card you inserted in step 2 (e.g. Apple SDCX Reader Media xxx GB).

   

6. Click Next.

7. Select Edit Settings.

   

8. In the General tab, select Set locale settings (e.g. for Germany time zone: Europe / Berlin and Keyboard layout: de). User configuration here is optional. The standard user info is:
   
   Username: rasqberry
   Password: Qiskit1!

   
   

   ! NOTE: There is no need to specify a username/password in the configuration settings. Doing so might lead to a gray screen when attempting to connect via VNC.

   

9. No further selections are needed in the Services tab.

   

10. Optional: Select the checkboxes as you can see in the picture below.

    

11. Click Yes to apply OS customization settings.

    

12. Click Yes to erase all existing data from the SD card and copy the above selected Rasqberry image to the SD card.

    

13. The writing process for the RasQberry Pi image will begin and will be completed after verification of the writing process.

    

14. Take the SD Card out of the SD Card reader and put it into your Raspberry Pi 5. Connect power and the RasQberry Pi will boot.