Email servers (SMTP) and password recovery
Who: a company's administrators set up its email server. The server administrators also set up the site email server.
Two email servers #
| Site email server | Company email server | |
|---|---|---|
| Where | Admin › Site email server (server administrators) | Admin › Email server (each company's administrators) |
| Sends | Password recovery links, confirmation emails for new company accounts, contact form messages, sign-up and feedback notices | The company's alert emails, daily summaries, DOT digests, evaluation and work order notices |
| Comes from | The site's From address | The company's own address |
A company without its own server can send through the site's when the server administrators allow it (Let companies without their own server use this one). That mail comes from the site's address, with the company's name, and replies go to the company's reply-to address.
Set up an email server #
- Open Admin › Email server (or Admin › Site email server).
- For a company, choose Our own email server (or The site's email server, or Don't send email).
- Choose the Provider. The server name, port and security are filled in, with a note on what that provider needs:
| Provider | Server | Port and security | Notes | |---|---|---|---| | Gmail / Google Workspace | smtp.gmail.com | 587 STARTTLS | Needs an app password: turn on 2-Step Verification, then Security › App passwords | | Microsoft 365 | smtp.office365.com | 587 STARTTLS | "Authenticated SMTP" must be on for the mailbox | | Outlook.com / Hotmail | smtp-mail.outlook.com | 587 STARTTLS | App password with two-step verification | | Yahoo Mail | smtp.mail.yahoo.com | 465 SSL/TLS | App password | | iCloud Mail | smtp.mail.me.com | 587 STARTTLS | App-specific password | | Zoho Mail | smtp.zoho.com | 465 SSL/TLS | smtp.zoho.eu in the EU | | AOL Mail | smtp.aol.com | 465 SSL/TLS | App password | | SendGrid | smtp.sendgrid.net | 587 STARTTLS | User name apikey, password = API key | | Mailgun | smtp.mailgun.org | 587 STARTTLS | Domain SMTP credentials | | Amazon SES | email-smtp.REGION.amazonaws.com | 587 STARTTLS | SES SMTP credentials | | Brevo | smtp-relay.brevo.com | 587 STARTTLS | SMTP login and key | | Other server | yours | yours | From your provider or IT department |
- Type the user name (usually the full address) and the password (or app password).
- Type the From address (with Gmail, Outlook and Yahoo: your own address), a From name and, if you like, a Reply-to address.
- For a company, list who receives alert emails (separate them with commas).
- Select Save, then Send a test message.
Expected result: "✓ Sent." and the message arrives (check the spam folder). When it fails, the reason is shown with what the server said, for example a refused password ("many providers need an app password") or a wrong port.
Password recovery #
Forgot your password? on the sign-in page sends a link to the email address saved for the sign-in (in its profile, Admin › Users and roles).
- Select Forgot your password?. Company users type their company code; server administrators leave it empty.
- Type the user name or email address, and select Email me a link.
- Open the link in the email within one hour and choose the new password twice.
Expected result: the password is changed, every session of that sign-in is signed out, and the person gets an email saying so. Two-step sign-in, when it is on, is still asked at the next sign-in.
- The page gives the same answer whether or not the sign-in exists, so nobody can find out names or addresses.
- Each link works once; a newer link replaces older ones. At most 5 requests an hour from one address.
- Recovery mail goes through the site email server (or, when it is not set up, the company's own).
- No email address saved, or no email server? An administrator sets a new password in Admin › Users and roles, as before.
If this does not work #
| Problem | What to do |
|---|---|
| "Username and Password not accepted" (535) | Use an app password (Gmail, Yahoo, iCloud, Outlook with two-step sign-in). For Microsoft 365, ask for Authenticated SMTP to be turned on. |
| Gmail: 535 "BadCredentials" with the right password | Google refuses the normal password. Sign in to Google as the same account as the user name, turn on 2-Step Verification, open myaccount.google.com/apppasswords, create an app password and paste the 16 letters (spaces are removed for you, 4.5.10). The user name is the full address. With Google Workspace, the Google administrator may have to allow app passwords. Since 4.5.10 the message says when the user name is not a full address or the password is not 16 letters. |
| "Could not connect" | Check the server name and port: 587 goes with STARTTLS, 465 with SSL/TLS. Some hosting providers block outgoing mail ports: ask them to open 587. |
| "That address is not allowed from a company account" | A company's server must be on the internet, not on the server's own network. |
| The test arrives in spam | Use your own domain's address as the From address, and ask your provider about SPF and DKIM for that domain. |
| No recovery email arrives | Check that the sign-in has an email address, and that the site email server's test works. |
Prepared by Franko.
Something here out of date or unclear? Tell your administrator and mention “email-server” and version 4.9.2.