Skip to content

FAQ

Jump to bottom
Jon Andre Briones edited this page Aug 14, 2026 · 2 revisions

How do I get out of Kiosk mode?

Attach a keyboard and press CTRL + ALT + DEL. That should allow you to log into Admin. From there you can disable Kiosk mode. Settings > Accounts > Other Users > Set up a kiosk.

This builds fine on MacOS/Linux, but doesn’t run on Windows

Check the libraries you’re using. If one of them has native bindings (like sharp, sqlite, or bcrypt) those will build using the pipeline’s environment i.e. Ubuntu, but they won’t work on Windows. You’ll either need to replace those libraries or (most likely) run the build pipe using Windows instead of Linux (ubuntu-latest -> windows-latest).

The latest build doesn’t launch or is super buggy, what should I do?

The health check on the autoupdater is limited; all it tests is that the /health endpoint is reachable. It does not check that the frontend works fine, the web server is reachable, or that the correct version is served. You have two options based on the state of the Kiosk:

  1. If the Kiosk’s health checks passed and it’s running the broken version, you’ll need to push a new version so that it can upgrade to that version.
  2. If the Kiosk is not running the new version because of a health check failure, you can delete the release on GitHub. You’ll also need to delete the tag in the git tree.

How do I change the behaviour of the auto-updater?

  • Disable: prevents future runs, but doesn't interrupt a current one.
Disable-ScheduledTask -TaskName "CSSS-Kiosk-Updater"
  • Stop: stops the current run immediately, be careful with this.
Stop-ScheduledTask -TaskName "CSSS-Kiosk-Updater"
  • Enable: re-enables the scheduled task.
Enable-ScheduledTask -TaskName "CSSS-Kiosk-Updater"
  • Unregister: deletes the task completely.
Unregister-ScheduledTask -TaskName "CSSS-Kiosk-Updater"

Clone this wiki locally