Installing and updating
- Install on Ubuntu 24.04 with
deploy/install.sh. With--domainand--emailit also sets up HTTPS;--time-zone Area/Citysets the school's time zone. - 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. - Check it is running:
systemctl status schoolstack, orcurl -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
- An update keeps the school's data: the backup is made first, and a failed update goes back to the version that worked.
- The rest of this page covers email, Sign in with Google, backups, server options and the command-line tool.
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)