Troubleshooting

Common issues and how to resolve them when using SINQ Authoring Tool.

App Won't Start

If the application fails to launch, check the following:

Antivirus: Add an exception for the .exe. Portable apps are sometimes flagged.
Port conflict: Ensure port 5000 (or the configured port) is not in use by another application.
Permissions: Run from a directory where you have write access. The app needs to create data files.

If you see MongoDB connection or startup errors:

Ensure no other MongoDB instance is running on the same port.
Delete the data folder in the app directory and restart (this will reset the database).
Check that the app has write permissions in its installation directory.

Data Loss

Deleting the data folder will remove all courses and user accounts. Only do this if you have backups or are okay with starting fresh.

If course builds fail or preview doesn't load:

Verify all required plugins are installed and enabled.
Check the browser console (F12) for JavaScript errors.
Try clearing the build cache: delete the build folder in your course directory and rebuild.

If you're still stuck, open an issue on the GitHub repository. Include your OS version, error messages, and steps to reproduce.