Skip to content

Commit

Permalink
Merge pull request #11143 from nextcloud/enh/noid/anchor-email-qa
Browse files Browse the repository at this point in the history
docs: use anchors for email configuration qa section
  • Loading branch information
susnux authored Sep 26, 2023
2 parents 22c4e68 + e96a80f commit 9e09e61
Showing 1 changed file with 26 additions and 21 deletions.
47 changes: 26 additions & 21 deletions admin_manual/configuration_server/email_configuration.rst
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ settings and look the same in all the different email clients out there.
showing HTML on the client (or removing the HTML part in the mail server).

Modifying the look of emails beyond the theming app capabilities
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

You can overwrite templates by writing a class that implements the template interface
(or extends it to not need to copy over everything). Easiest way is to then put this class into
Expand Down Expand Up @@ -144,7 +144,7 @@ If you prefer, you may set your mail server parameters in ``config/config.php``.
The following examples are for SMTP, Sendmail, and Qmail.

SMTP
^^^^
""""

If you want to send email using a local or remote SMTP server it is necessary
to enter the name or IP address of the server, optionally followed by a colon
Expand Down Expand Up @@ -209,7 +209,7 @@ and password.
"mail_smtppassword" => "password",

Sendmail
^^^^^^^^
""""""""

If you want to use the well known Sendmail program to send email, it is
necessary to have an installed and working email system on your \*nix server.
Expand All @@ -229,7 +229,7 @@ Nextcloud should be able to send email out of the box.
"mail_smtppassword" => "",

qmail
^^^^^
"""""

If you want to use the qmail program to send email, it is necessary to have an
installed and working qmail email system on your server. The qmail binary
Expand Down Expand Up @@ -270,9 +270,10 @@ the ``mail_smtpdebug`` parameter in ``config/config.php``.
before, several **SMTP -> get_lines(): ...** messages appear on the screen.
This is expected behavior and can be ignored.

**Question**: Why is my web domain different from my mail domain?
Why is my web domain different from my mail domain?
"""""""""""""""""""""""""""""""""""""""""""""""""""

**Answer**: The default domain name used for the sender address is the hostname
The default domain name used for the sender address is the hostname
where your Nextcloud installation is served. If you have a different mail domain
name you can override this behavior by setting the following configuration
parameter:
Expand All @@ -286,9 +287,10 @@ reset email) having the domain part of the sender address appear as follows::

no-reply@example.com

**Question**: How can I find out if an SMTP server is reachable?
How can I find out if an SMTP server is reachable?
""""""""""""""""""""""""""""""""""""""""""""""""""

**Answer**: Use the ping command to check the server availability::
Use the ping command to check the server availability::

ping smtp.server.dom

Expand All @@ -299,10 +301,10 @@ reset email) having the domain part of the sender address appear as follows::
time=3.64ms


**Question**: How can I find out if the SMTP server is listening on a specific
TCP port?
How can I find out if the SMTP server is listening on a specific TCP port?
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

**Answer**: The best way to get mail server information is to ask your mail
The best way to get mail server information is to ask your mail
server admin. If you are the mail server admin, or need information in a
hurry, you can use the ``netstat`` command. This example shows all active
servers on your system, and the ports they are listening on. The SMTP server is
Expand Down Expand Up @@ -335,16 +337,16 @@ listening on localhost port 25.
* 995/tcp/udp is encrypted pop3s


**Question**: How can I determine if the SMTP server supports the SMTPS
protocol?
How can I determine if the SMTP server supports the SMTPS protocol?
"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

**Answer**: A good indication that the SMTP server supports the SMTPS protocol
A good indication that the SMTP server supports the SMTPS protocol
is that it is listening on the `submissions` port **465**.

**Question**: How can I determine what authorization and encryption protocols
the mail server supports?
How can I determine what authorization and encryption protocols the mail server supports?
"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

**Answer**: SMTP servers usually announce the availability of STARTTLS
SMTP servers usually announce the availability of STARTTLS
immediately after a connection has been established. You can easily check this
using the ``telnet`` command.

Expand Down Expand Up @@ -374,9 +376,10 @@ using the ``telnet`` command.

.. _TLSPeerVerification:

**Question**: How can I send mail using self-signed certificates or use STARTTLS with self signed certificates?
How can I send mail using self-signed certificates or use STARTTLS with self signed certificates?
"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

**Answer**: To disable peer verification or to use self signed certificates, add the following
To disable peer verification or to use self signed certificates, add the following
to your ``config/config.php``::

"mail_smtpstreamoptions" => array(
Expand All @@ -387,9 +390,11 @@ to your ``config/config.php``::
)
),

**Question**: All emails keep getting rejected even though only one email address is invalid.

**Answer**: Partial sending, i. e. sending to all but the faulty email address is not possible.
All emails keep getting rejected even though only one email address is invalid.
"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

Partial sending, i. e. sending to all but the faulty email address is not possible.

Enabling debug mode
-------------------
Expand Down

0 comments on commit 9e09e61

Please sign in to comment.