Test 3

Help › For the person who runs the server

Email (password-reset links)

With email on, people who forget their password get a link by email ("Forgot your password?" on the Sign in page) instead of asking you. SchoolStack sends through an email service; the steps below are for Brevo (free for up to 300 emails a day). Your site needs its domain first.

  1. In Brevo: Senders, Domains & Dedicated IPs ▸ Domains ▸ Add a domain, type your domain, and add the DNS records Brevo shows at your domain's DNS provider. Wait until Brevo says Authenticated.
  2. In Brevo: SMTP & API ▸ SMTP. Note the Login shown there, and choose Generate a new SMTP key. Keep the key private: don't send it to anyone or paste it into a chat.
  3. In the server's console, run /opt/schoolstack/bin/schoolstack-email-setup. Type the login, then paste the key (it doesn't show as you type) and press Enter. The site restarts with email on, sending as no-reply@ your domain.
  4. On Users ▸ Email, choose Send me a test email. It arrives within a minute or two (look in spam the first time). If it fails, the page says why.

Good to know: SchoolStack uses port 2525, because DigitalOcean blocks the usual email ports on new accounts. Another service works too: /opt/schoolstack/bin/schoolstack-email-setup --host smtp.example.com --port 587. To turn email off: /opt/schoolstack/bin/schoolstack-email-setup --off. The settings live in /etc/schoolstack/schoolstack.env (readable by root only), and re-running the installer keeps them.

Example: After Brevo shows schoolstack.me as authenticated, the owner runs /opt/schoolstack/bin/schoolstack-email-setup, pastes the key, and sends a test email from Users. From then on a student who forgets their password resets it themselves.

Related: Sign in with Google · Administrators and the Users page · Daily summary email