summaryrefslogtreecommitdiffstats
path: root/doc/install
diff options
context:
space:
mode:
authoresethna <eric@spinpunch.com>2015-10-14 14:36:19 -0600
committeresethna <eric@spinpunch.com>2015-10-14 14:36:19 -0600
commit7523c6f2e6b52c6aaa40900d4b9a6d8b461ba446 (patch)
treee3bc7d631533034d4cd0e8fabcfaa97e1fd8c177 /doc/install
parent4ad9e0673ca8950597a290f10db10475b18b67cc (diff)
downloadchat-7523c6f2e6b52c6aaa40900d4b9a6d8b461ba446.tar.gz
chat-7523c6f2e6b52c6aaa40900d4b9a6d8b461ba446.tar.bz2
chat-7523c6f2e6b52c6aaa40900d4b9a6d8b461ba446.zip
Update SMTP instructions
Needs dev review.
Diffstat (limited to 'doc/install')
-rw-r--r--doc/install/SMTP-Email-Setup.md41
1 files changed, 23 insertions, 18 deletions
diff --git a/doc/install/SMTP-Email-Setup.md b/doc/install/SMTP-Email-Setup.md
index 86e2bb20e..0c3004c5f 100644
--- a/doc/install/SMTP-Email-Setup.md
+++ b/doc/install/SMTP-Email-Setup.md
@@ -1,17 +1,17 @@
## SMTP Email Setup
-In some product evaluation setups email is intentionally bypassed using a `ByPassEmail=true` option. This option allows account creation and system operation without having to set up an email service (e.g. no email verification is required for account creation). This also means neither email notifications nor password reset by email are available.
+In some product evaluation setups, email is intentionally bypassed by setting `SendEmailNotifications=false`. This option allows account creation and system operation without having to set up an email service (e.g. no email verification is required for account creation). This also means neither email notifications nor password reset by email are available.
-To enable email, turn this option off by setting `ByPassEmail=false` and configuring an SMTP email service as follows:
+To enable email, turn this option on by setting `SendEmailNotifications=true` and configuring an SMTP email service as follows:
1. **Set up an SMTP email sending service.** (If you already have credentials for a SMTP server you can skip this step.)
1. [Setup Amazon Simple Email Service](https://console.aws.amazon.com/ses)
2. From the `SMTP Settings` menu click `Create My SMTP Credentials`
3. Copy the `Server Name`, `Port`, `SMTP Username`, and `SMTP Password`
4. From the `Domains` menu setup and verify a new domain. It it also a good practice to enable `Generate DKIM Settings` for this domain.
- 5. Choose an email address like `feedback@example.com` for Mattermost to send emails from.
- 6. Test sending an email from `feedback@example.com` by clicking the `Send a Test Email` button and verify everything appears to be working correctly.
+ 5. Choose an email address like `mattermost@example.com` for Mattermost to send emails from.
+ 6. Test sending an email from `mattermost@example.com` by clicking the `Send a Test Email` button and verify everything appears to be working correctly.
2. **Modify the Mattermost configuration file config.json or config_docker.json with the SMTP information.**
1. If you're running Mattermost on Amazon Beanstalk you can shell into the instance with the following commands
2. `ssh ec2-user@[domain for the docker instance]`
@@ -19,20 +19,25 @@ To enable email, turn this option off by setting `ByPassEmail=false` and configu
4. Retrieve the name of the container with `sudo docker ps`
5. `sudo docker exec -ti container_name /bin/bash`
3. **Edit the config file `vi /config_docker.json` with the settings you captured from the step above.**
- 1. See an example below and notice `ByPassEmail` has been set to `false`
- ``` bash
- "EmailSettings": {
- "ByPassEmail" : false,
- "SMTPUsername": "AKIADTOVBGERKLCBV",
- "SMTPPassword": "jcuS8PuvcpGhpgHhlcpT1Mx42pnqMxQY",
- "SMTPServer": "email-smtp.us-east-1.amazonaws.com:465",
- "UseTLS": true,
- "FeedbackEmail": "feedback@example.com",
- "FeedbackName": "Feedback",
- "ApplePushServer": "",
- "ApplePushCertPublic": "",
- "ApplePushCertPrivate": ""
- }
+ 1. See an example below and notice `SendEmailNotifications` has been set to `true`
+ ```
+ "EmailSettings": {
+ "EnableSignUpWithEmail": true,
+ "SendEmailNotifications": true,
+ "RequireEmailVerification": true,
+ "FeedbackName": "No-Reply",
+ "FeedbackEmail": "mattermost@example.com",
+ "SMTPUsername": "AFIADTOVDKDLGERR",
+ "SMTPPassword": "DFKJoiweklsjdflkjOIGHLSDFJewiskdjf",
+ "SMTPServer": "email-smtp.us-east-1.amazonaws.com",
+ "SMTPPort": "465",
+ "ConnectionSecurity": "tls",
+ "InviteSalt": "bjlSR4QqkXFBr7TP4oDzlfZmcNuH9YoS",
+ "PasswordResetSalt": "vZ4DcKyVVRlKHHJpexcuXzojkE5PZ5eL",
+ "ApplePushServer": "",
+ "ApplePushCertPublic": "",
+ "ApplePushCertPrivate": ""
+ },
```
4. **Restart Mattermost**
1. Find the process id with `ps -A` and look for the process named `platform`