noor

Help › For the person who runs the server

Installing and updating

  1. Install on Ubuntu 24.04 with deploy/install.sh. With --domain and --email it also sets up HTTPS; --time-zone Area/City sets the school's time zone.
  2. Update with /opt/schoolstack/bin/schoolstack-update: it backs up, gets the latest code, builds, restarts, checks that the site works, and rolls back if it doesn't.
  3. Check it is running: systemctl status schoolstack, or curl -s http://127.0.0.1:8080/healthz (it answers "ok", the number of users, and the last minute's pages and their slowest 5%).

Good to know

Example: A teacher reports a fix is merged. The owner opens the DigitalOcean console, pastes /opt/schoolstack/bin/schoolstack-update, waits for "Update finished", and opens the site on their phone to check.

Related: Where the data lives · Server options · Email (password-reset links)