YunoHost/doc
1
0
Fork 0
mirror of https://github.com/YunoHost/doc.git synced 2024-09-03 20:06:26 +02:00
Code Issues Projects Releases Packages Wiki Activity

Update email_configure_relay.md

Browse source
This commit is contained in:
slowphil 2021-05-26 22:39:31 +02:00 • committed by GitHub
parent 83fcb829e1
commit ca107977b4
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 17 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

28
pages/01.administrate/07.specific_use_cases/07.email_relay/email_configure_relay.md
View file

@ -7,20 +7,24 @@ routes:
default: '/email_configure_relay'
---
If your ISP blocks port 25, if you can't set a reverseDNS on your server, or if you have any other troubles using the built-in SMTP server on YunoHost, you may want to setup your YunoHost server to use a SMTP relay.
If your ISP blocks port 25, if you can't set a reverseDNS on your server, or if you have any other troubles using the built-in SMTP server on YunoHost, you may want to setup your YunoHost server to use an SMTP relay.
## What is a SMTP relay?
## What is an SMTP relay?
A SMTP relay is basically a third party hosted SMTP server that will send emails on behalf of your own SMTP server (Postfix service on YunoHost).
Once setup correctly on YunoHost, it will operate in a totally transparent manner, both for you and for your correspondents: they will see emails as coming from your YunoHost main URL, but all the sending will be delegated to the SMTP relay you have chosen and configured.
An SMTP relay is basically a third party hosted SMTP server that will send emails on behalf of your own SMTP server (Postfix service on YunoHost).
Once setup correctly on YunoHost, its operation is transparent, both for you and for your correspondents: they will see emails as coming from your YunoHost main URL, but all the sending will be delegated to the SMTP relay you have chosen and configured.
! [fa=exclamation-triangle /] It's important to note that using a SMTP relay has to be seen as a (big) compromise in the world of self-hosting. Indeed, when using a SMTP relay, you will not only let a third party send emails on your behalf, but also be able to access to the full content of all the emails you'll send. Be also aware that a SMTP relay is setup for your whole YunoHost server: you can't choose which emails or which users go through it because all future emails will.
## Disadvantages of SMTP relays ! [fa=exclamation-triangle /]
## How to use a SMTP relay with YunoHost?
It's important to note that using an SMTP relay has to be seen as a (big) compromise in the world of self-hosting. Indeed, when using an SMTP relay, not only a third party sends emails on your behalf, but it has full access to the content of all the emails you'll send and can also possibly modify them (For example, by default, MailJet rewrites the html hyperlinks contained in your emails, in order to track the activity of your correspondents). Be also aware that an SMTP relay is setup for your whole YunoHost server: you can't choose which emails or which users go through it because all future emails will.
Beyond the privacy considerations above, an SMTP relay can impose technical limitations that one would not have if port 25 was open. For example, with most relays, if a user of your Yunohost server declares **an external "forwarding address"** in order to automatically forward messages received on your Yunohost server to another mailbox, **such forwarding will not work** for emails originating from outside your server, without any warning. Indeed, relays generally require that the messages they forward have a sender address from your domain (to fight spam and preserve the reputation of their services), which is not the case for an "automatic forward" where the original sender of the mail is kept; the message is then blocked by the relay (which, normally, warns the Yunohost admin, but only afterwards)
## How to use an SMTP relay with YunoHost?
YunoHost has a built-in SMTP relay configuration, available from version 4.1. That configuration is not yet available from the admin web interface, though. You will have to use the command line interface.
### Step 1: Register on a SMTP relay provider
### Step 1: Register with an SMTP relay provider
Many providers exist. Some have free plans with or without limitations, it's up to you. As written above, you have to be careful with your choice as you will basically handover all your emails to that third party. Whether you can trust it or not, that's your call!
@ -38,12 +42,13 @@ Please note that modifying your DNS records could sometimes take over 24h to tak
### Step 3: Setup YunoHost correctly
In order to setup your YunoHost to use your SMTP relay, you will have to configure three things:
In order to setup your YunoHost to use your SMTP relay, you will have to configure four things:
1. Your SMTP relay URL (for this tutorial we will use `smtprelay.tld`)
2. Your SMTP relay username (for this tutorial we will use `username`)
3. Your SMTP relay password (for this tutorial we will use `password`)
2. The port on which you access the relay (for this tutorial we will use port 2525 below)
3. Your SMTP relay username (for this tutorial we will use `username`)
4. Your SMTP relay password (for this tutorial we will use `password`)
Your SMTP relay will obviously provide you with these three things, that should be available in your control panel or whatsoever.
Your SMTP relay will obviously provide you with these four things, that should be available in your control panel or whatsoever.
You can log into your YunoHost server using SSH:
```bash
@ -54,6 +59,7 @@ Then you can update the three values as below:
```bash
sudo yunohost settings set smtp.relay.host -v smtprelay.tld
sudo yunohost settings set smtp.relay.port -v 2525
sudo yunohost settings set smtp.relay.user -v username
sudo yunohost settings set smtp.relay.password -v password
```