The SchoolStack dashboard
The dashboard is a separate site, like https://panel.schoolstack.me, where the owner (the
master admin) and their helpers add and look after the schools on the server, without the
command line. It never shows a school's people or work: only numbers.
Start it once: after schoolstack-update, run sudo /opt/schoolstack/bin/schoolstack-panel-setup
and answer: its address (Enter keeps panel.<your domain>), your name, your email and the contact
shown on a paused school's site. You get an email with a link to choose your dashboard password
(look in Spam too). Email must be on first (Email).
Signing in: email and password; the first time on each phone or computer a 6-digit code is emailed as well, and that device is then remembered for 30 days. Five wrong passwords pause signing in for 15 minutes.
What it does:
- Schools: every school with up or down, students, teachers, space used and a warning when a
school has more students than its limit. Add a school asks the same as
schoolstack-add-schoolplus its record. An address under your domain works at once; for the school's own domain the school's page shows the DNS record to add, and the dashboard makes the school as soon as the address points to the server (it checks every minute). - A school's page: its numbers and speed for 7 days; Pause (its site says "This school is paused. Please contact …", nobody can sign in, nothing is deleted, backups go on) and Resume; Back up now; its backups and Restore (a backup of now is made first); Email the welcome link again; its record (contact person, phone, email, notes, start date, most students, storage for uploaded files, which is applied); Remove this school (type its short name; a last backup is kept 30 days). The main school can be backed up, not paused or removed, from here.
- Server: memory, disk, how busy, the version, and Update all (the same as
schoolstack-update). Adding more servers waits for the business decisions (proposal U3). - Helpers (master admin only): add a helper by email; helpers add schools, pause and resume them, back them up and keep records. Only the master admin removes schools, restores backups, updates, adds helpers and changes Settings. Activity lists who did what, and when.
Security (owner, 2026-11-20):
- Signing in: with a passkey (face or fingerprint, every time; add one on Security on each phone or computer), or with the password and a 6-digit code emailed the first time on each device, which is then trusted for 7 days. A sign-in lasts 12 hours on phones and tablets and 24 hours on computers.
- Devices: every signed-in phone and computer (when last seen, its internet address); Sign out this device or Sign out everywhere. The master admin also sees the helpers' devices.
- Alert address (on Security): a second email, not on your phone, gets an email at every sign-in, passkey added or removed, sign-out everywhere, lock and unlock.
- Asking again: before Remove this school, Restore, Update all and Add a helper, the dashboard asks again: your passkey, or your password and a new emailed code.
- Emergency lock and the console:
sudo /opt/schoolstack/bin/schoolstack-dashboard locksigns everyone out and stops every sign-in untilsudo /opt/schoolstack/bin/schoolstack-dashboard unlock. The same command works while the dashboard runs (or on its file when it's stopped), and each action is in Activity as "Server console":schools,add,pause NAME,resume NAME,backup NAME,backups NAME,restore NAME BACKUP,remove NAME,devices,signout NUMBER,signout --everyone.
How it works: the dashboard (schoolstack-panel) runs without administrator rights; a small helper
on the server (schoolstack-agent, schoolstack-server agent) asks it for work every few seconds,
does it with the same commands as above and reports numbers back. Its data is
/var/lib/schoolstack-panel/panel.json; logs: journalctl -u schoolstack-panel and
journalctl -u schoolstack-agent.
Example: The owner runs schoolstack-panel-setup, chooses a password from the email and signs in on
the iPhone with the emailed code. A school asks to join: on Add a school they type alnoor,
alnoor.schoolstack.me, the names and the head teacher's email; a minute later the school is
Ready and the head teacher has the welcome email. When the school stops paying, the owner opens
it and chooses Pause.
Related: Several schools on one server · Speed and watching · Email (password-reset links)