# Confusing email documentation

**URL:** https://meta.discourse.org/t/confusing-email-documentation/328774
**Category:** Self-hosting
**Tags:** email
**Created:** [October 1, 2024, 3:06am UTC](https://meta.discourse.org/t/confusing-email-documentation/328774 "2024-10-01T03:06:45Z")
**Posts on this page:** 7
**Page:** 1

<div class="post-metadata">

### Author: ![Aroldo\_Barroso](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/aroldo_barroso/32/452563_2.png) [@Aroldo\_Barroso](https://meta.discourse.org/u/Aroldo_Barroso)
#### Post date: [October 1, 2024, 3:06am UTC](https://meta.discourse.org/t/confusing-email-documentation/328774/1 "2024-10-01T03:06:45Z")

</div>

I swear to God, I’ve been sitting in a chair for 4 hours trying to figure out how to set up my forum to send emails. I looked at the Discourse documentation and didn’t understand a thing. I found hundreds of questions here on the forum, but the administrators who answer have a habit of answering very technically, with few instructions. I feel like a real idiot incapable of doing something that should be so simple. It took me a little over 40 minutes to set up a Debian station, install Discourse, open the ports on my firewall and get it to work on my DDNS. However, I’ve been trying to figure out for 4 hours how to set up the email to notify new users, validate registrations, etc. Is there really no step-by-step tutorial? I’ve looked everywhere on the internet and couldn’t find anything. Could someone who knows how to do it, who is having a good day, in a good mood and with a light heart, help me? Thank you! May God bless the soul of whoever helps me!

---

<div class="post-metadata">

### Author: ![Architect](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/architect/32/520575_2.png) [@Architect](https://meta.discourse.org/u/Architect)
#### Post date: [October 1, 2024, 3:16am UTC](https://meta.discourse.org/t/confusing-email-documentation/328774/2 "2024-10-01T03:16:36Z")

</div>

You need to set up a mail sender to do that such as mailgun, brevo, elastic email, or another that is the first step you must choose your sender then there are few steps to make that work.

Firstly this means you need to create an account with a transactional e-mail sender then integrate that with your discourse install.

This is step two of the [standard install](https://meta.discourse.org/t/142537?silent=true):

> <https://github.com/discourse/discourse/blob/main/docs/INSTALL-cloud.md>

> <https://github.com/discourse/discourse/blob/main/docs/INSTALL-email.md>

This is the troubleshooting guide:

> [@Troubleshoot email on a new Discourse install](https://meta.discourse.org/t/troubleshoot-email-on-a-new-discourse-install/16326):
>
> You just installed Discourse via [the install guide](https://github.com/discourse/discourse/blob/main/docs/INSTALL.md), but email doesn’t seem to work. Unfortunately this means you can’t log in as an admin to finalize the install. cry Let’s troubleshootize! Try the doctor woman_health_workerIf you run ./discourse-doctor it will check several ways that your mail configuration might be broken, and offer advice. Try that first. Did you enter email settings correctly? The simplest way is to run ./discourse-setup again. Did you enter everything correctly? B…

---

<div class="post-metadata">

### Author: ![Architect](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/architect/32/520575_2.png) [@Architect](https://meta.discourse.org/u/Architect)
#### Post date: [October 1, 2024, 3:40am UTC](https://meta.discourse.org/t/confusing-email-documentation/328774/4 "2024-10-01T03:40:55Z")

</div>

There is a way:

> [@Disable Email Verification for Discourse Plugin](https://meta.discourse.org/t/disable-email-verification-for-discourse-plugin/280874):
>
> envelope_with_arrowSummary Disable Email Verification for Discourse is a fork of the unmaintained angelim/discourse\_user\_auto\_activation and provides an option for administrators to bypass the email verification step during user registration. No more waiting for email confirmations; get users started immediately.hammer_and_wrenchRepository Link [https://github.com/codergautam/disable-email-verification-discourse](https://github.com/codergautam/disable-email-verification-discourse)open_bookInstall Guide [How to install plugins in Discourse](https://meta.discourse.org/t/install-plugins-in-discourse/19157) …

But firstly to create a new site you need to have an administrator e-mail address.

---

<div class="post-metadata">

### Author: ![Aroldo\_Barroso](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/aroldo_barroso/32/452563_2.png) [@Aroldo\_Barroso](https://meta.discourse.org/u/Aroldo_Barroso)
#### Post date: [October 1, 2024, 3:41am UTC](https://meta.discourse.org/t/confusing-email-documentation/328774/5 "2024-10-01T03:41:26Z")

</div>

Do you know how to REMOVE the requirement to verify email to create new accounts? The only thing I needed for email to work was the function to validate new registrations. I think this is also unnecessary. The user can simply enter their name and password and they are already on the forum. Can you tell me if this is possible?

---

<div class="post-metadata">

### Author: ![Aroldo\_Barroso](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/aroldo_barroso/32/452563_2.png) [@Aroldo\_Barroso](https://meta.discourse.org/u/Aroldo_Barroso)
#### Post date: [October 1, 2024, 3:42am UTC](https://meta.discourse.org/t/confusing-email-documentation/328774/6 "2024-10-01T03:42:06Z")

</div>

Thank you my friend!

---

<div class="post-metadata">

### Author: ![Architect](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/architect/32/520575_2.png) [@Architect](https://meta.discourse.org/u/Architect)
#### Post date: [October 2, 2024, 10:16pm UTC](https://meta.discourse.org/t/confusing-email-documentation/328774/7 "2024-10-02T22:16:07Z")

</div>

Any reason why you don’t like email?

---

<div class="post-metadata">

### Author: ![Lilly](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/lilly/32/575047_2.png) [@Lilly](https://meta.discourse.org/u/Lilly)
#### Post date: [October 3, 2024, 5:26am UTC](https://meta.discourse.org/t/confusing-email-documentation/328774/8 "2024-10-03T05:26:31Z")

</div>

Hi @Aroldo_Barroso 👋 I’m sorry you’re having trouble finding the information you need to setup email. Most of the installation and set up information you are looking for can be found in the #Documentation category. Maybe have a look at these topics:

> [@Troubleshoot email on a new Discourse install](https://meta.discourse.org/t/troubleshoot-email-on-a-new-discourse-install/16326?silent=true):
>
> You just installed Discourse via [the install guide](https://github.com/discourse/discourse/blob/main/docs/INSTALL.md), but email doesn’t seem to work. Unfortunately this means you can’t log in as an admin to finalize the install. cry Let’s troubleshootize! Try the doctor woman_health_workerIf you run ./discourse-doctor it will check several ways that your mail configuration might be broken, and offer advice. Try that first. Did you enter email settings correctly? The simplest way is to run ./discourse-setup again. Did you enter everything correctly? B…

> [@Email delivery configuration checklist](https://meta.discourse.org/t/email-delivery-configuration-checklist/209839?silent=true):
>
> Email deliverability is complicated. Here are a few important things you should check first: Be sure to set the DISCOURSE\_NOTIFICATION\_EMAIL: correctly in your app.yml file. The domain specified in the “from” address of the emails you send is the domain your email will be validated against. Know how to view the raw source of the email in your mail client, so you can examine email headers for important clues. In Gmail, it is the “show original” option in the drop-down menu at the top right …
