Notifications
People can turn on small notifications on their phones and computers (see Settings ▸ Notifications). There is nothing to set up and nothing to pay for:
- They use web push, which every current browser has. The server sends each notification,
encrypted so only the device can read it, to the push service of the device's browser maker
(Apple, Google, Mozilla or Microsoft). These services are free and need no account or key from
you. The server's network must reach them (
web.push.apple.com,fcm.googleapis.com,updates.push.services.mozilla.com,*.notify.windows.com); the droplet can. - The site must be on https (it is:
https://schoolstack.me). - The first time it starts, the server makes its own push key and keeps it in
/var/lib/schoolstack/push-key.json, readable by the server only. It is never in the repository and never shown. Keep it: if it is deleted, everyone's devices stop getting notifications until each person turns them on again. - Which devices have them on is kept in
/var/lib/schoolstack/push.json(each device's push address and keys, never anything to sign in with). - The server checks every minute. Nothing is sent between 21:00 and 07:00 in each person's time zone, and at most 4 a day per person. Turned-off and deleted accounts get nothing.
Example: After the update, the owner opens SchoolStack from the iPhone's Home Screen, goes to Settings ▸ Notifications, taps Turn on notifications on this device, allows them, and taps Send a test notification: "Test notification – Notifications work on this device." arrives (the iPhone adds "from SchoolStack").
Related: Notifications · Test accounts · Daily summary email