Skip to content

Commit

Permalink
docs: update mail.md to add generic SMTP settings (#3392)
Browse files Browse the repository at this point in the history
  • Loading branch information
stumpyfr authored and djaiss committed Dec 29, 2019
1 parent e7dfece commit 0a8a2de
Showing 1 changed file with 19 additions and 1 deletion.
20 changes: 19 additions & 1 deletion docs/installation/mail.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,25 @@ For this, you will require an SMTP server. If you don't have one of these, your
* [Postmark](https://postmarkapp.com/)
* [Mailgun](https://signup.mailgun.com/new/signup) (the [free plan](https://www.mailgun.com/pricing) should be sufficient)
* [Amazon Simple Email Service](https://aws.amazon.com/ses/)
* [Sendgrid](https://sendgrid.com)

## Use SMTP with Monica

The generic way to send emails with Monica is to provide a SMTP server, each one of the services mentionned above can provide you SMTP settings. While Amazon SES is a little bit custom, see bellow, here the configuration for a standard SMTP configuration.

You need to add few environment variables in your configuration (working in generic installation and Docker):
```
MAIL_DRIVER: smtp
MAIL_HOST: smtp.service.com # ex: smtp.sendgrid.net
MAIL_PORT: 587 # is using tls, as you should
MAIL_USERNAME: my_service_username # ex: apikey
MAIL_PASSWORD: my_service_password # ex: SG.Psuoc6NZTrGHAF9fdsgsdgsbvjQ.JuxNWVYmJ8LE0
MAIL_ENCRYPTION: tls
MAIL_FROM_ADDRESS: no-reply@xxx.com # ex: email you want the email to be FROM
MAIL_FROM_NAME: Monica # ex: name of the sender
```

Restart Monica to take in effect the new settings, quickest option to confirm is to add someone to your account (add one of your own email) and you will receive the invitation!


## Use Amazon SES with Monica
Expand Down Expand Up @@ -64,4 +82,4 @@ APP_EMAIL_NEW_USERS_NOTIFICATION=



Now you're all done! If you've changed your `.env` file since you last started Monica, use `php artisan setup:production -v` so that Monica reads your new configuration.
Now you're all done! If you've changed your `.env` file since you last started Monica, use `php artisan setup:production -v` so that Monica reads your new configuration.

0 comments on commit 0a8a2de

Please sign in to comment.