Skip to content

Editions ​

QuestionBank comes in two deployment editions with exactly the same features. They differ in where they run and the scale they suit.

Edition Model ​

QuestionBank
├── Desktop edition (Windows tray app / macOS menu-bar app)
│   ├── Personal use   —— binds to 127.0.0.1, local access only, single user
│   └── LAN sharing    —— enabled from the tray, binds to 0.0.0.0 + firewall rule, multiple users on the same subnet
└── Server edition (Docker Compose)
    —— MySQL + ChromaDB + Backend + Worker + Frontend, for teams / production

Comparison ​

AspectDesktop · Personal UseDesktop · LAN SharingServer Edition
Runs onWindows / macOS desktop appWindows / macOS desktop appServer / Docker
InstallationOne-click installerOne-click installerDocker Compose
DatabaseSQLite (built in)SQLite (built in)MySQL 8.0
Access scopeThis computer onlySame LANLAN / intranet / internet (self-configured)
Multiple usersMainly single userYes, everyone shares one data setYes, built for teams
Data directory%APPDATA%/QuestionBank%APPDATA%/QuestionBankServer volumes / MySQL
UpgradesInstall over the existing versionInstall over the existing versionPull new images and recreate
Maintenance effortVery lowLowMedium (requires running Docker/MySQL)
Best forIndividual teachers, lesson prepTeaching groups, computer labs, small teamsSchools / organizations / production deployments

Which One Should I Use? ​

  • Only on your own computer → Desktop edition · Personal Use
  • A few people sharing one question bank in the same office / computer lab → Desktop edition · LAN Sharing
  • Larger teams that need an always-on service, intranet / internet access, or stronger concurrency and backups → Server edition

Data is portable

The desktop and server editions share the same data model. As your team grows, you can migrate from the desktop edition to the server edition (export questions / migrate the database) without re-entering questions. See Database & Migrations for the migration steps.

LAN Sharing vs. the Server Edition ​

Both support multiple users, but they serve different purposes:

  • LAN sharing is a switch in the desktop edition: it temporarily opens the desktop app on your computer to colleagues on the same subnet and depends on your computer being on. It is off by default and suits lightweight collaboration.
  • The server edition runs on an always-on server with MySQL, offering better concurrency, stability, and backups. It suits a team's official question bank service.

Released under the AGPL-3.0 License