← All help topics

✉️ Email

How the system sends email — sender, delivery method, a test button, alerts and the daily data-backup email.

The Email page (under Settings) is where you set up how the portal sends email. Once it is configured, the system can email you the nightly health-check alerts and an automatic daily backup of all your data.

Choosing how email is sent

Pick a delivery method:

  • Local pickup folder (IIS SMTP) — the simplest on a server that already runs the Windows/IIS SMTP service. The system writes each email as a file into the SMTP Pickup folder (for example C:\inetpub\mailroot\Pickup) and Windows delivers it. No relay host or login is needed — just the folder path, and the app must be allowed to write to it.
  • SMTP relay — sends through a mail server you provide: host, port, and (if the server needs it) a username and password. Use port 465 with *Implicit TLS*, or 587 / 25 without it (STARTTLS is used automatically when the server offers it).

Then set the From address (sender) — the address every email appears to come from. Write a plain address or a name plus address, e.g. CodeB Laundry <laundry@your-domain.com>.

Testing it

  1. Fill in the delivery method and sender, then press Save email settings.
  2. Under Test it, optionally type a recipient (otherwise your alert or backup recipients are used).
  3. Press Send test email. A green message confirms it was sent; a red one shows exactly what went wrong so you can fix it.
Note The test always uses the last saved settings — save first, then test.

Health-check break alerts

Turn on Email me when a nightly check fails and enter one or more recipients to have the nightly check (see System health) email its report whenever a golden-rule invariant breaks. This is in addition to the on-screen dashboard banner, which is always shown.

Daily data-backup email

Turn on Email a full backup every day at midnight to have the system email a complete backup of itself to the recipients you choose, once a day at 00:00 (Malta time).

  • The attachment is a .zip — exactly the same full, restorable backup as the Backup & Restore download: all linen data plus the connection settings and the server .env.
  • The subject is yours to set. Include {date} (the backup’s date) or {tenant} (this system’s name) and they are filled in automatically — handy for filing each day’s backup.
  • Press Send a backup now to email one immediately — it works even while the daily send is switched off, so you can check it before turning it on.
Watch out The backup contains credentials in clear text (OIDC / PMS / fleet API keys and, from .env, the session secret and the built-in superuser login). Send it only to trusted internal addresses, and treat every copy like a password.
Note Timing: the daily send is driven by site traffic (so it survives the server recycling itself), which means on a completely idle night it goes out with the first request after midnight rather than exactly at 00:00.

Open Email settings