nativeInstallermattermost

Configure SMTP for outbound emails

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and Mac OS X) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). Learn more.

Follow these steps:

  • Log in to Mattermost as an administrator.

  • Browse to the “System Console”.

  • Navigate to the “Notifications -> Email” menu and set the values for your SMTP server. For example, to configure a Gmail server, use the values below. Remember to replace USERNAME and PASSWORD with your Gmail account username and password.

    • Enable Email Notifications: true
    • SMTP Server Username: USERNAME@gmail.com
    • SMTP Server Password: PASSWORD
    • SMTP Server: smtp.gmail.com
    • SMTP Server Port: 587
    • Connection Security: TLS
  • Click “Test Connection” to validate the connection. If the connection succeeds, click “Save” to save the changes.

    Mattermost SMTP configuration

To configure the application to use other third-party SMTP services for outgoing email, such as Hotmail or Amazon SES, refer to the Mattermost official documentation.

To configure the application to use other third-party SMTP services for outgoing email, such as SendGrid or Mandrill, refer to the FAQ.

NOTE: If you are using Gmail as the outbound email server and have experienced issues trying to send emails correctly, check the Gmail SMTP troubleshooting page to learn the causes of these issues and how to solve them.