In this section · 12 articles

Emails from Laramin don't arrive

A password reset, a verification code or an add-on's alert never arrives, although the screen said it was sent. Find which of Laramin's two ways of sending carried it, and fix that one.

Applies to
Core 12.7 and later
Who can do this
Platform owner, Administrator
On this page

Symptom

Someone expected an email from your Laramin and it never came. The screen gave no sign of a problem: a password reset still says Check your inbox, and an administrator's Reset password still says "Password reset link has been sent to …".

Two ways your Laramin sends email

Which way an email went decides where to look:

Sent byWhich emailsWhere a failure shows
Notification Manager, when it's installed and turned onEvery business event: password reset links, temporary passwords, and every add-on's alertsA row in Notification Manager › Logs
Laramin's own mailer, alwaysCodes from the mobile app (sign-up, verification and password reset), monitoring alerts, email address verification links, and, when Notification Manager is off, password resets and a few account-security messagesOnly the server's log

Without Notification Manager, the temporary password from Set password and every add-on's alert are never emailed at all.

Check these, in order

1. Notification Manager still has its placeholder mail server

Notification Manager installs its SMTP email provider as Active, pointing at a placeholder mail server (127.0.0.1, port 1025). Until someone enters a real mail server, every email it sends fails. Password resets that worked before Notification Manager was installed stop, because it takes them over.

In Notification Manager › Logs, the email rows show Failed, with an Error Message that starts Connection could not be established with host "127.0.0.1:1025".

Fix: enter your real mail server. Open the Settings hub, then Notification Providers › Email Settings, and fill in the SMTP tab. See Connect an email, SMS, WhatsApp or push provider. If saving is refused, see A delivery provider won't switch on.

If your Laramin was installed with Core 12.8.1 or earlier

Installing locked away Notification Manager's starting email details in a form Laramin can't read. On Email Settings, SMTP Host, SMTP Port, SMTP Username, From Address and From Name look empty although nobody cleared them, and Status still shows Active. The log rows show Connection could not be established with host ":587", with no host before the port. Upgrading to 12.8.2 doesn't repair this by itself.

Fix:

  1. Ask whoever runs your server to run this command. It changes nothing; it lists every saved value Laramin can't read.

    Bash
    php artisan app:check-encrypted
  2. If it lists nm_providers with smtp, open Email Settings (you need Edit Providers & Settings). On the SMTP tab, fill in every field: SMTP Host, SMTP Port, Encryption, SMTP Username, SMTP Password, From Address and From Name. Type the password even if you think it's saved: an empty box keeps the unreadable one. Do the same on AWS SES if ses is listed.

    Email Settings on the SMTP tab, with Status Active and every field filled in: host, port 587, TLS, username, password, From Address and From Name. Save changes is highlighted.
  3. Select Save changes. While Status is Active, Laramin tests the connection first and saves nothing if the test fails. Enter a real mail server, or set Status to Inactive to save without one.

  4. Run the command again. It should answer Every encrypted value can be read with the current APP_KEY.

The command may list other rows too, such as a Payment Gateway's credentials. Enter each one again on its own settings screen.

2. Background work isn't running

When Connection in Developer Tools › Developer Settings › Queue Settings is Database or Redis, Notification Manager queues every email, and nothing is sent until the queue is worked through. Messages wait with no row in the logs. On Sync, where a new installation starts, emails are sent straight away and this doesn't apply.

Fix: see Scheduled jobs don't run.

3. Notification Manager decided not to send

The event is off, its add-on is off, no template has Enable Dispatch on, the template isn't approved, or the person turned that notification off. The row says skipped, or there's no row.

Fix: see A notification wasn't sent or didn't arrive. If a notification you turned off is sent again, see A notification you turned off is sent, or goes out on the wrong channel.

4. Laramin's own mailer isn't set up

Mobile app codes, monitoring alerts and verification links always go through Laramin's own mailer, and so does everything when Notification Manager is off. It has no settings screen. It uses the MAIL_ values in the server's settings file:

.env
MAIL_MAILER=smtp
MAIL_HOST=smtp.example.com
MAIL_PORT=587
MAIL_USERNAME=YOUR_MAIL_USERNAME
MAIL_PASSWORD=YOUR_MAIL_PASSWORD
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=noreply@crm.example.com
MAIL_FROM_NAME="Your company"

Replace the highlighted values with your own.

A failure is written to the server's log as Fallback Notification Broker Mail error, followed by the event and the reason. Without MAIL_FROM_ADDRESS, sending fails with An email must have a "From" or a "Sender" header.

Fix: whoever runs the server fills these in, then runs php artisan config:clear. To find the file your Laramin reads, see A setting or a change to the settings file doesn't take effect.

If you're on Core 12.8.1 or earlier

Laramin ignored MAIL_HOST, MAIL_USERNAME, MAIL_PASSWORD and MAIL_ENCRYPTION from the settings file, so its own mailer never reached your mail server. The log line names a host with nothing before the port, such as ":2525". Fix: upgrade Core to 12.8.2. Nothing needs entering again. See Run a system upgrade.

5. Notification Manager isn't installed

Without it, Laramin's own mailer sends only password resets and a few account-security messages. The temporary password from Set password, and every add-on's alert, are never emailed.

Fix: install Notification Manager and connect a mail server, or give people the information yourself. See Reset or set a user's password.

6. The add-on sent it to nobody, or to someone else

Some add-ons decide who gets an email:

7. It was sent, but went to spam or was refused

A Notification Manager row says Sent, so your mail server accepted it. Ask the person to check their spam folder, and check that your mail provider lets you send from the From Address. See A notification wasn't sent or didn't arrive.

Still not working?

Raise a ticket from Support Center in your Laramin app. Include this page's link, which email didn't arrive, whether Notification Manager is installed, and the Error Message of any log row. Don't include passwords.