How do I setup SMTP on a Discourse Droplet ?

June 21, 2016 1.9k views
One-Click Install Apps Email

Just installed the Discourse droplet, changed the root password, and followed the prompts. I was asked for SMTP information and thought it was as simple as using the default, adding my email address, and be done with it. However, emails are not being sent.

Is there another step that I missed?

6 Answers


Configuring and administering a mail server on your own is not always an easy, straight forward task. We have a great tutorial/article about some of the issues you might run into:

If you DO decide you want to run your mail server after reading that article, we have a lot of articles about different options to setup a mail server: Depending on your skill level I would either suggest mail in a box ( for an easier solution or send-only postfix ( for a more advanced solution.



When setting up a web site or application under your own domain, it is likely that you will also want a mail server to handle the domain's incoming and outgoing email. While it is possible to run your own mail server, it is often not the best option for a variety of reasons. This guide will cover many of the reasons that you may not want to run your own mail server, and offer a few alternatives.

I have the same question as the original poster. And, if I may say so, I feel that Andrews does not answer the question.

I am quite happy to have you handle my mail server but at the first SSH sign-in I was asked for my SMTP settings and I think I may have given the wrong port.

How can I change the SMPT port now?

Thank you

cd /var/discourse
./launcher rebuild app

I have the same problem. I've almost completed the Discourse setup, but I can't log in and complete the process because the confirmation email never sends. My mail server (and web host) are 1and1. I used app.yml to change the port from 587 to 25, as advised on another forum post, but that didn't work. Does anyone have a fix for this? I'm blocked.

  • Hi Shalom, I have the same problem, with 1and1 as the mail provider, did you resolve it?

    • Ah, my issue was a # in the password - which the app.yml helpfully mentions could be an issue.

Hi, I'm also having difficulty getting the registration email to work for the admin account.

I'm using Zoho as my email provider. I have successfully configured DKIM and SPF. The production.log file shows this where the email address is a valid address.

Sent mail to (1449.1ms)
Job exception: end of file reached

Any suggestions? I read through the questions and answers in without luck. Here is a snippet of app.yml.


## TODO: The SMTP mail server used to validate new accounts and send notifications
DISCOURSE_SMTP_PASSWORD: "longpasswordforaboveusername"
#DISCOURSE_SMTP_ENABLE_START_TLS: true # (optional, default true)
edited by asb
  • Hi bdschaap,
    I have literally the same issue. I've tried changing the port to 465, turning Start TLS to false and none of them work. Have you found a solution to using zoho for discourse?

    • Same problem here. Tried every combination there is.

      I suspect we need to add a new line with "login" or "password" as a parameter.

Have another answer? Share your knowledge.