Upgrade & Uninstall
Upgrading to a New Version
- Download the latest installer from GitHub Releases.
- Right-click the tray icon → Quit to close the running app.
- Run the new installer and install over the existing version.
Your data is kept
An upgrade installs over the existing version: program files are replaced, but your data directory %APPDATA%\QuestionBank (SQLite database, uploaded files, configuration) is not affected. To be safe, we still recommend making a backup before upgrading.
First launch after upgrading
On its first launch, a new version automatically tidies up old data in the background (for example, moving images previously inserted into questions into the Media Library). Questions remain usable during this process, which usually takes a few seconds to a few minutes and runs only once.
The installer automatically ends the running old version during an upgrade. If you see a "file in use" message, quit the app manually first and try again.
macOS: quit the app with ⌘Q, open the new DMG, drag QuestionBank into Applications and choose Replace. The data directory ~/Library/Application Support/QuestionBank is not affected.
Trying the Preview Version
The Preview version (version numbers with -alpha / -beta, e.g. 1.5.0-alpha.1) is fully isolated from the stable version; you can install and run both at the same time:
| Stable | Preview | |
|---|---|---|
| Program name | QuestionBank | QuestionBank Preview |
| Icon color | Teal | Amber |
| Data directory (Windows) | %APPDATA%\QuestionBank | %APPDATA%\QuestionBank-Preview |
| Data directory (macOS) | ~/Library/Application Support/QuestionBank | ~/Library/Application Support/QuestionBank-Preview |
| macOS app name | QuestionBank.app | QuestionBank Preview.app |
| Address | http://localhost:8000 | http://localhost:8001 |
On its first launch, if the Preview version finds data from the stable version, it asks whether to copy it over for testing:
- Yes: the Preview version uses a copy; the stable version's data is not modified.
- No: the Preview version starts fresh.
If the stable version uses a MySQL database, the data cannot be copied automatically and the Preview version starts fresh. In that case, do not connect the Preview version to the database the stable version is using.
When you no longer need the Preview version, uninstall QuestionBank Preview in Settings → Apps, then delete %APPDATA%\QuestionBank-Preview. The stable version is not affected.
Signing in to both
When both versions are open on the same computer, signing in to one may require you to sign in again to the other. This is expected.
Uninstalling
- Right-click the tray icon → Quit.
- In Windows Settings → Apps or Control Panel → Programs and Features, find QuestionBank and uninstall it.
The uninstaller will:
- End the running app process;
- Remove the program files and the startup entry;
- Remove the firewall rule added by LAN sharing.
macOS
- Quit the app with ⌘Q (or right-click the Dock icon → Quit).
- Drag QuestionBank from Applications to the Trash.
- Open at Login stops working once the app is gone; if it still shows under System Settings → General → Login Items, remove it there.
Is Data Kept After Uninstalling?
Uninstalling does not automatically delete your data directory (Windows: %APPDATA%\QuestionBank; macOS: ~/Library/Application Support/QuestionBank).
- To remove everything: delete the directory manually.
- To keep / migrate it: copy the directory first, then delete it; after reinstalling, put it back to restore your data.
Deletion is permanent
Manually deleting the data directory permanently deletes all your question bank data. Make sure you have a backup before doing this.