inchworks/quizinch repository overview

⁠QuizInch

This application enables the synchronised display of questions, answers and scores for a live quiz.

At a minimum it needs two computers:

• A laptop or Raspberry Pi connected to the digital projector at a venue, runnning the QuizInch server.
• A laptop to enter scores, running just a web browser and connected to the first computer via WiFi.

Additional displays for different purposes are supported using any devices that have a web browser.

The server software is written in Go for good performance. The system does not need an internet connection. Configuration files are provided to turn a Raspberry Pi into a quiz appliance that starts automatically and provides a dedicated WiFi network.

For more information see https://inchworks.com/info/quizinch⁠.

⁠Licenses

This image contains software licensed under GPL v3, MIT LIcense and Google's license for Go.

⁠Installation

At a minimum a server needs just this docker-compose.yml file in e.g. /srv/quizinch: version: '3'

services:

  db:
    image: mariadb:10.4
    container_name: quiz_db
    expose:
      - 3306
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: "<root-password>"
      MYSQL_DATABASE: quiz
      MYSQL_USER: server
      MYSQL_PASSWORD: "<server-password>"
    volumes:
      - mysql:/var/lib/mysql
    logging:
      driver: "json-file"
      options:
        max-size: "2m"
        max-file: "5"

  quiz:
    image: inchworks/quizinch:latest
    ports:
      - 80:8000
    restart: always
    environment:
      db-password: "<server-password>"
      options: "RPi"
    volumes:
      - /etc/localtime:/etc/localtime:ro 
      - ./media:/media
      - ./site:/site:ro
    logging:
      driver: "json-file"
      options:
        max-size: "5m"
        max-file: "5"
    depends_on:
      - db

volumes:
  mysql:

Edit the example to change the following items:

• MY_SQL_ROOT_PASWORD
• MYSQL_PASSWORD and db-password. Make them the same.