Simple Mail Transfer Protocol (SMTP) is a system of rules for sending emails. Modern email clients and accounts rely on it to ensure emails reach their recipient's inbox.
NamelessMC will directly send emails without a mail server by default. Not all hosting providers allow this. If emails aren't sending or end up in the spam folder, and your SPF & DKIM records are correct, then it's likely an issue with the implementation (sendmail on Unix) and/or the server's php.ini
file. Unless you have access to troubleshoot these, an external mail server is recommended.
A third party SMTP provider like gmail can be set up with Nameless if the default email configuration doesn't work. In order to do this, head into the StaffCP -> Configuration -> Email
tab, and toggle on the Enable PHPMailer?
option. The fields below this option then need filling out depending on whether you wish to use Gmail or another SMTP server.
In general, username
should be set to your email address, password
to your password, name
to anything you like and port
to 587. Some provider-specific instructions are provided below. Please note that for most email providers, your Outgoing email address
should be set to the same value as username
, or they will refuse to deliver your email.
smtp.gmail.com
587
smtp-mail.outlook.com
587
Edit the core/classes/Core/Email.php
file, around line 109 change
$mail->SMTPDebug = SMTP::DEBUG_OFF;
to
$mail->SMTPDebug = SMTP::DEBUG_LOWLEVEL;
NamelessMC will now print detailed debugging information when it sends an email. Please note that this debug information may contain sensitive data, you should revert this change when you're done.
To revert, change back to SMTP::DEBUG_OFF
.
E-mail submission can use two protocols:
core/config.php
, secure
should be set to tls
(default).core/config.php
, secure
should be set to ssl
.The secure options "tls" and "ssl" are incorrectly named for historical reasons. Both actually use TLS, but in a different way. Both are secure. See RFC 8314 for more info.