Razzia

Razzia is an open-source, self-hosted quiz platform designed for hosting interactive trivia games and competitions at small events. The software operates as a web application that allows a manager to coordinate live games while participants join via a browser using a room code. It serves as a tool for organizers who need a private environment to facilitate interactive learning or competitive gaming sessions.

Deployment occurs on a server using either Docker Compose or a manual Node.js installation. The application persists game settings and quiz data through a local configuration folder on the host machine. This architecture allows administrators to edit configuration files directly, maintain settings across container updates, and perform manual backups of all created quizzes and game parameters.

Key features

• Self-hosted deployment via Docker or Node.js
• Manager interface for game control
• Room code system for participant access
• Persistent storage for quizzes and settings
• Custom branding and theming options
• WebSocket protocol for building custom clients
• Configuration via JSON files

The application is built using React and TypeScript. To ensure security, the software requires the manual definition of a manager password in the game configuration file before it can be used in a live environment. If the default password is not changed, administrative access is blocked by the system. The platform is designed to be flexible regarding network setups and can be run behind various reverse proxies such as Traefik, Nginx, or Caddy.

One notable technical aspect is the exposed WebSocket protocol. This allows developers to extend the platform by building custom hardware clients. For example, users can integrate physical buzzers using ESP32 controllers to replace the standard browser interface for participants. This makes the software suitable for events that prefer tactile inputs over mobile devices.

Razzia is intended for organizers of small-scale trivia events who require a private, customizable environment for interactive learning or gaming.