Raspberry Pi Setup

Before installation

• Set up a Raspberry Pi 4 or 400 with Raspberry Pi OS Bullseye. See raspberrypi.com. (Version Bookworm is unlikely to work.)

• Install Docker and Docker Compose. Check docs.docker.com for the latest instructions. At the time of writing, this was the recommended method:

    cd ~/.
    curl -fsSL https://get.docker.com -o get-docker.sh
    sudo sh get-docker.sh
    sudo usermod -aG docker $USER
    newgrp docker
  

You can check that Docker is installed successfully by: docker run hello-world.

Install QuizInch

A basic installation requires the creation of just one file on the server.

1. Create a directory /srv/quizinch for the server: sudo install -d -m 0755 -o $USER /srv/quizinch.

2. Add docker-compose.yml to the server directory. This Docker Compose file specifies the QuizInch and MariaDB software to be downloaded from Docker Hub, the settings to run them on the host system, and essential application parameters. ⇒ Docker Setup

3. cd /srv/quizinch and run docker compose up -d. When issued the first time, this fetches QuizInch and MariaDB software from Docker Hub, and starts QuizInch. Then QuizInch sets up the quiz database, and creates the directory to hold media files (/srv/quizinch/media). QuizInch will be restarted automatically whenever the RPi appliance is switched on. ⇒ Commands

4. If needed, you can customize the quiz system: ⇒ Customisation

5. Optionally, reconfigure the system with a menu to start the quiz display automatically, and to host a WiFi network. ⇒ Make RPi Appliance

6. Connect to your server at http://localhost/ using a web browser and view the home page for the quiz system.