Home

Darkhold

Darkhold is a self-hosted quiz portal that mimics the fun-filled, energetic quiz platform of Kahoot. We are not related to Kahoot and are not planning to steal their functionality; we intend to provide a similar but limited set of features to the open-source world.

Features

Currently, any logged-in user can upload a set of questions in an Excel sheet with a predefined format. Once the Excel is uploaded, the logged-in user can create a challenge and wait for the participants to join. Once the participants join via a quiz pin, the logged-in user can trigger the challenge and run the quiz. The logged-in user can also participate in the quiz, and the quiz window will be similar for everyone. We extend the quiz for remote users as well (in the same network / or internet via Ngrok)

Running the app in your dev environment

Prerequisites

• JDK 25
• Java IDE of your choice (I work with IntelliJ IDEA community edition)
• Git (without this also it will also work fine, as most of the IDEs support direct checkout)

Steps for testing the Application

• From git-bash or IntelliJ IDEA, start up the Spring Boot app (./build.sh clean bootRun)
• We have built it using the H2 database
• The application will be up and running at http://localhost:8181/
• Try signing in with the following credentials: Username: admin@admin.com, password: admin.
• Explore !!!

Running the app in Docker

• Docker Usage

Technologies used

• Java 25
• spring-boot 3+
• Hibernate 5+
• Bootstrap 5+
• Gradle 9+
• H2 Embedded DB
• Nitrate NoSQL embedded DB