🧩 What is this project?

Rahoot is a straightforward and open-source clone of the Kahoot! platform, allowing users to host it on their own server for smaller events.

⚠️ This project is still under development, please report any bugs or suggestions in the issues

⚙️ Prerequisites

Choose one of the following deployment methods:

Without Docker

• Node.js : version 22 or higher
• PNPM : Learn more about here

With Docker

• Docker and Docker Compose

📖 Getting Started

Choose your deployment method:

🐳 Using Docker (Recommended)

Using Docker Compose (recommended): You can find the docker compose configuration in the repository: docker-compose.yml

docker compose up -d

Or using Docker directly:

docker run -d \
  -p 3000:3000 \
  -v ./config:/app/config \
  ralex91/rahoot:latest

Configuration Volume: The -v ./config:/app/config option mounts a local config folder to persist your game settings and quizzes. This allows you to:

• Edit your configuration files directly on your host machine
• Keep your settings when updating the container
• Easily backup your quizzes and game configuration

The folder will be created automatically on first run with an example quiz to get you started.

The application will be available at http://localhost:3000

🛠️ Without Docker

1. Clone the repository:

git clone https://github.com/Ralex91/Rahoot.git
cd ./Rahoot

2. Install dependencies:

pnpm install

3. Build and start the application:

# Development mode
pnpm run dev

# Production mode
pnpm run build
pnpm start

⚙️ Configuration

The configuration is split into two main parts:

1. Game Configuration (config/game.json)

Main game settings:

{
  "managerPassword": "PASSWORD"
}

Options:

• managerPassword: The master password for accessing the manager interface. Must be changed from the default "PASSWORD" value, otherwise manager access is blocked.

2. Quiz Configuration (config/quizz/*.json)

Create your quiz files in the config/quizz/ directory. You can have multiple quiz files and select which one to use when starting a game.

Example quiz configuration (config/quizz/example.json):

{
  "subject": "Example Quiz",
  "questions": [
    {
      "question": "What is the correct answer?",
      "answers": ["No", "Yes", "No", "No"],
      "image": "https://images.unsplash.com/....",
      "solution": 1,
      "cooldown": 5,
      "time": 15
    }
  ]
}

Quiz Options:

• subject: Title/topic of the quiz
• questions: Array of question objects containing:
  • question: The question text
  • answers: Array of possible answers (2-4 options)
  • image: Optional URL for an image displayed with the question
  • video: Optional URL for a video displayed with the question
  • audio: Optional URL for an audio played during the question
  • solution: Index of correct answer (0-based)
  • cooldown: Time in seconds before showing the question
  • time: Time in seconds allowed to answer

🎮 How to Play

1. Access the manager interface at http://localhost:3000/manager
2. Enter the manager password (defined in config/game.json)
3. Share the game URL (http://localhost:3000) and room code with participants
4. Wait for players to join
5. Click the start button to begin the game

📝 Contributing

1. Fork the repository
2. Create a new branch (e.g., feat/my-feature)
3. Make your changes
4. Create a pull request
5. Wait for review and merge

For bug reports or feature requests, please create an issue.

⭐ Star History