OpenMasjid Docs
Home
GitHub
Home
GitHub

Email and alerts

What you need

Time: 20 minutes

  • You are signed in to the dashboard.
  • Either a Resend account, or the SMTP details for an email address your masjid owns.

You set up email once, in one place. After that OpenMasjidOS can email you when something breaks, and your apps can send donation receipts without ever seeing the password.

Choose a provider

Open Settings, then Email. Provider offers three choices.

Provider Choose it when
Resend You want the simplest path. Paste one API key.
SMTP Your masjid already has an email address you want messages to come from.
Off (no email) You are not ready. Alerts and receipts are simply not sent.

With Resend

  1. Set Provider to Resend.
  2. Paste your key into Resend API key.
  3. Fill in From address and From name.
  4. Click Save.

Getting the key is on the Resend page.

With SMTP

  1. Set Provider to SMTP.
  2. Fill in SMTP host, Port, SMTP username and SMTP password.
  3. If the port is 465, tick Use TLS (port 465).
  4. Fill in From address and From name.
  5. Click Save.

Prove it works

  1. Click Send test email.
  2. Check the inbox of the address on your admin account.
Result:

The dashboard says Verified and saved. and reports Test email sent to your address. A red message instead means the details are wrong; nothing is saved until it passes.

Choose which alerts you get

Open the Alerts group. Every alert has two switches: Email and Webhook. Both are on by default.

Alerts appear as you install apps, so an empty list on a new install is correct. What you get includes an app going offline, an update being available, and a card payment being disputed.

Send alerts to Discord or Slack as well

If your committee already uses a group chat, alerts can go there too.

  1. Open the Notifications group.
  2. Turn on Enable notifications.
  3. Choose Slack, Discord or Webhook under Where to send.
  4. Paste the incoming-webhook address from that service into Webhook URL.
  5. Put your masjid's name in Label, so a shared channel shows where the message came from.
  6. Click Send test.
Result:

A test message appears in the channel.

Checkpoint

A test email arrived, and the alert list shows both Email and Webhook switches for every alert.

If something goes wrong

What you seeWhyWhat to do
Could not send the test email. Check your settings.Wrong host, wrong port, wrong password, or a From address the provider will not allow.Check the port and TLS pair first: 465 with TLS ticked, or 587 with it unticked. Then check the From address is at a domain the provider owns.
The test says it sent, but nothing arrives.It was delivered to spam, or the provider is holding new accounts for review.Check the spam folder. With Resend, check that the sending domain is verified.
No alerts are listed.Alerts arrive with apps, and none is installed yet.Nothing to do. Install an app and the list fills in.
On this page