Raspberry Pi Setup

Before installation

Set up a Raspberry Pi 4, 400, 5 or 500 with Raspberry Pi OS Bookworm 64-bit, or a later version. See raspberrypi.com.
Install Docker Engine. Check docs.docker.com for the latest instructions. At the time of writing, the instructions for Debian apply to Raspberry Pi OS 64-bit.
Enable docker to run without sudo: sudo usermod -aG docker $USER && newgrp docker.

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

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

Create a directory /srv/quizinch for the server: sudo install -d -m 0755 -g $USER -o $USER /srv/quizinch.
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
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
If needed, you can customize the quiz system: ⇒ Customisation
Connect to your server at http://localhost/ using a web browser from the Raspberry Pi OS desktop and view the home page for the quiz system.
Optionally, reconfigure the system with a menu to start the quiz display automatically, and to host a WiFi network. After rebooting the QuizInch system menu will show the appliance’s IP address, as needed to connect an external web browser. ⇒ Make RPi Appliance