Sending emails
Augias sends invoices, quotes, payment reminders and account emails through a mail transport you configure: your own SMTP server or a delivery service. Until one is configured, nothing is sent.
Two levelsβ
- A default for the whole server, set with the
AUGIAS_MAILER_DSNenvironment variable. Every company that has not configured its own delivery uses it. - Per company, in
Settings>Email: theSender Information(address and name shown in "From") and, optionally, anEmail Deliveryservice with its credentials. A company's own delivery replaces the server default for its emails.
The server defaultβ
AUGIAS_MAILER_DSN takes a Symfony Mailer DSN. Some examples:
# Any SMTP server β port 587 uses STARTTLS, port 465 implicit TLS
AUGIAS_MAILER_DSN=smtp://user:password@smtp.example.com:587
# An address as the user name: write its @ as %40
AUGIAS_MAILER_DSN=smtp://invoices%40example.com:password@mail.example.com:587
# Amazon SES
AUGIAS_MAILER_DSN=ses+smtp://ACCESS_KEY:SECRET_KEY@default?region=eu-west-3
Characters such as @, : or / in the password must be URL-encoded too.
Set it where your installation reads its environment: the environment of the containers with Docker, the chart's values with Helm, or the server's environment. You can also keep it out of files entirely as a secret:
bin/console secrets:set AUGIAS_MAILER_DSN
Per companyβ
In Settings > Email:
- Under
Sender Information, set the address emails are sent from and the name shown beside it. Replies go to that address. - Under
Email Delivery, leave the service empty to use the server default, or choose one β SMTP, Gmail, Mailgun, Mailchimp, Postmark, SendGrid or Amazon SES β and fill in its credentials.
The sender address must belong to a domain that allows your transport to send for it, or your emails will land in spam. See below.
Getting emails deliveredβ
Receiving servers check that the sender's domain authorises the server that sent the email. On the domain of your sender address, publish:
- an SPF record listing your transport (your provider gives the
include:to add); - the DKIM key your provider gives you, so emails are signed;
- a DMARC policy, starting with
p=nonewhile you check the results.
Then send an invoice to the address mail-tester.com gives you: it scores the email and says what is missing.
Checking the configurationβ
Send a test email with the server default:
bin/console mailer:test you@example.com --from=invoices@example.com
Emails are sent by the background worker. If the test arrives but invoices do not, check that the worker (the messenger:consume process) is running.
In developmentβ
The development stack (docker-compose.dev.yml) runs Mailpit, which catches every email the application sends and shows it at http://localhost:8025. Nothing reaches a real address. The tests send nothing at all.
Troubleshootingβ
Nothing is sent and there is no errorβ
No transport is configured: AUGIAS_MAILER_DSN still has its default, null://null, which discards every email, and the company has no delivery service of its own. Set one of the two.
Emails arrive in spamβ
The sender's domain does not authorise your transport. Publish SPF, DKIM and DMARC records on that domain as above, or send from an address on a domain your transport is set up for.
Connection could not be established with hostβ
The host or port is wrong, or the server cannot reach it: many hosting providers block outgoing port 25. Use port 587 or 465, which your provider documents.