Quick wins for a faster PC:
Scan for outdated or missing drivers - takes under a minuteDriver Scan →Clear out junk files and repair common Windows errorsFree Scan →Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →Configure Joomla email in System → Global Configuration → Server. Set the sender address and name, choose PHP Mail, Sendmail, or SMTP, then enter the mail provider’s host, port, security mode, authentication, username, and password. Save the configuration and use Send Test Mail; a successful submission confirms that Joomla handed the message to the transport, but it does not prove inbox delivery.
Antihost offers Linux VPS plans with full root access, unlimited traffic on a 1 Gbps port and a 14-day free trial.
Where Joomla email settings are located
Joomla keeps its site-wide outgoing-mail settings in the administrator area. Sign in with an account allowed to change global configuration, then open System → Global Configuration → Server. The Mail section controls messages generated by Joomla core and by extensions that use Joomla’s mail service.
As an Amazon Associate I earn from qualifying purchases.
PC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11Crashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minuteBefore changing anything, have the details supplied by your hosting company or mail provider available: an outgoing SMTP hostname, port, encryption method, whether authentication is required, and the account credentials. These values are provider-specific; copying settings from a different provider can prevent delivery or cause a connection error.
Configure the sender and choose a mailer
- Open System → Global Configuration → Server.
- In the Mail section, enter From Email. Use an address that your domain or mail provider permits as a sender.
- Enter the site or organization name in From Name. Visitors may see this name in their mail client.
- Choose one of Joomla’s mailers: PHP Mail, Sendmail, or SMTP.
- Click Save, then select Send Test Mail to check the configuration.
Joomla’s user guide suggests trying PHP Mail first, then Sendmail, and then SMTP if the earlier method does not deliver. That sequence is practical on conventional hosting, but SMTP is usually the more predictable choice when the site runs on a local computer, a restricted server, or a provider that requires authenticated and encrypted submission.
#1 Best Overall
PHP Mail, Sendmail, or SMTP: which should you use?
| Mailer | How it hands off mail | Authentication and encryption | Best fit | Typical diagnostic experience |
|---|---|---|---|---|
| PHP Mail | Passes the message to the server’s PHP mail function. | Depends on the server’s mail setup rather than Joomla’s provider credentials. | Hosting environments that already support PHP mail and permit the site to send. | Simple to enable, but failures can be difficult to distinguish from host-level filtering. |
| Sendmail | Uses a Sendmail-compatible local mail-transfer program. | Controlled by the local mail-transfer configuration. | Servers where the administrator has configured Sendmail or a compatible binary. | Useful when the local service is known to work; troubleshooting requires access to server mail logs. |
| SMTP | Connects directly to an outgoing mail server. | Supports provider-defined authentication and security modes such as SSL/TLS or STARTTLS. | Localhost installations, managed SMTP accounts, and providers that require authenticated submission. | Host, port, security, and credential fields provide clearer points to check. |
The hosting environment must support the selected transport. SMTP does not bypass a firewall or a provider policy: the server still needs permission to make an outbound connection to the chosen port, and the account must be allowed to submit mail.
Set up SMTP in Joomla
Enter the provider’s connection details
- In System → Global Configuration → Server → Mail, set Mailer to SMTP.
- Enter the provider’s SMTP Host, such as the hostname documented for your mail account.
- Enter the provider’s SMTP Port. Port 25 is commonly paired with no security or STARTTLS; ports 465 and 587 are commonly used for encrypted connections. The provider’s instructions take precedence over these common patterns.
- Choose SMTP Security: None, SSL/TLS, or STARTTLS, exactly as required for the selected port.
- Set SMTP Authentication to the provider’s requirement. If authentication is enabled, enter the account in SMTP Username and its password in SMTP Password.
- Save the configuration and select Send Test Mail.
Do not combine settings merely because each value looks familiar. For example, an SSL/TLS connection on port 465 is a different setup from STARTTLS on port 587. A wrong security mode can produce a timeout, a TLS negotiation error, or an authentication failure even when the hostname and password are correct.
What a successful test does—and does not—prove
Joomla’s test button checks whether the configured transport can accept the message for sending. If Joomla displays a green success message, the server or SMTP service accepted the submission. It does not guarantee that the recipient’s mail provider delivered the message to the inbox. Check the destination inbox and its spam or junk folder, and allow for provider-side filtering or delay.
Rank #2
In Joomla 5.3, Send Test Mail targets the currently logged-in administrator’s email address. Verify that address in the user account before testing, particularly on a staging site where the administrator address may not be the address you expected.
Gmail SMTP settings for Joomla
For a Gmail account, Joomla’s J4.x documentation gives this working configuration:
| Joomla field | Value |
|---|---|
| Mailer | SMTP |
| SMTP Host | smtp.gmail.com |
| SMTP Port | 465 |
| SMTP Security | SSL/TLS |
| SMTP Authentication | Yes |
| SMTP Username | Your Gmail username |
| SMTP Password | An app-specific password |
Port 587 with STARTTLS is also documented as a working Gmail combination. Use one complete pairing: port 465 with SSL/TLS, or port 587 with STARTTLS.
Do these 3 things before closing this tab:
1Scan for outdated or missing drivers - takes under a minute2Clear out junk files and repair common Windows errors3Fix the driver behind crashes, sound loss and screen glitchesUse an app-specific password correctly
Gmail’s documented Joomla setup uses an app-specific password rather than your normal account password. Google may display that password in groups separated by spaces; enter the characters without spaces in Joomla’s SMTP Password field. Keep the password private and regenerate it if it is exposed. If your Google account or organization does not permit the required sign-in method, the SMTP connection can still be refused even when every Joomla field is correct.
Joomla email on localhost
PHP Mail settings that work on a hosted site often fail on localhost. A local PHP installation may have no mail-transfer agent, no configured relay, or no permission to open an outbound connection. The result can be a test that appears to run without any message arriving, or an explicit transport error.
For a local Joomla installation, switch the mailer to SMTP and use the same outgoing-mail host, port, security mode, username, and password configured in your normal mail client. Then send a test to an address you can check, including its spam folder. This approach gives the local site an authenticated relay instead of relying on an unconfigured local mail service.
Rank #4
Localhost checks
- Confirm that the computer or development server can make outbound connections to the provider’s SMTP port.
- Check that antivirus software, a firewall, or an organization network is not blocking the connection.
- Verify that the SMTP account allows authenticated submission from the network you are using.
- Use the provider’s exact security mode; do not substitute port 25, 465, or 587 without changing the corresponding encryption setting.
- After Joomla reports success, inspect both the inbox and spam folder.
Modern authentication and OAuth 2.0
Some providers no longer permit a basic username-and-password SMTP login for every account. Where supported, Joomla provides an SMTP OAuth 2.0 flow for providers that require modern authentication. OAuth replaces a reusable password with a provider-authorized token and a consent process.
Before starting an OAuth setup
- Confirm that your Joomla version and mail provider support the OAuth 2.0 integration you intend to use.
- Have the provider’s application or consent details ready, and sign in with an account allowed to grant consent.
- Check organization policy. Microsoft organization or security settings can disable SMTP AUTH, in which case an OAuth configuration cannot work until the administrator permits the required SMTP capability.
Follow the provider-specific authorization screens and return to Joomla only after consent succeeds. If authorization completes but sending fails, check whether the account is allowed to use SMTP AUTH and whether the selected host and port match the provider’s modern-authentication documentation.
Troubleshoot a failed Joomla test email
No message arrives, but Joomla reports success
- Check the destination inbox, spam, junk, quarantine, and any server-side filtering view.
- Confirm the recipient address used by the test. On Joomla 5.3 and later, the test targets the currently logged-in user.
- Verify that the sender address is permitted by the SMTP account and the domain’s mail policy.
- Ask the mail provider whether it accepted, deferred, or rejected the message; Joomla’s green status alone cannot confirm inbox placement.
Connection timeout or refused connection
- Recheck the SMTP hostname for spelling and the provider’s required port.
- Make sure the server firewall, local firewall, or hosting company permits outbound SMTP traffic on that port.
- Try the provider’s alternate documented encrypted combination, such as 465 with SSL/TLS or 587 with STARTTLS, but change the security setting with the port.
- On localhost, verify that the network permits the connection and that the provider accepts the account from that environment.
TLS or encryption errors
- Match None, SSL/TLS, or STARTTLS to the provider’s instructions.
- Do not use STARTTLS on a connection that requires implicit SSL/TLS, or implicit SSL/TLS where the provider expects STARTTLS.
- Check that the server’s clock and TLS support are current enough for the provider’s certificate and protocol requirements.
Authentication failure
- Re-enter the SMTP username exactly as the provider expects; some services require the full email address.
- Replace a normal account password with the required app-specific password when the provider documents that requirement.
- Remove spaces or line breaks accidentally copied into an app password.
- If the provider requires OAuth 2.0, use Joomla’s OAuth flow where available instead of repeatedly trying a blocked basic login.
- For managed Microsoft accounts, ask the organization administrator whether SMTP AUTH is disabled by policy.
Messages work from one extension but not another
First establish that Joomla itself can send. The programmers’ documentation advises configuring Global Configuration → Server and confirming that Send Test Mail works before debugging extension mail code. If the core test fails, fix the transport, credentials, or provider policy first. If it succeeds, inspect the extension’s recipient, sender, template, queue, and event settings without changing the global mail configuration unnecessarily.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Validate delivery beyond the test button
- Send the Joomla test to the address shown for the logged-in administrator, especially on Joomla 5.3 or newer.
- Check the inbox and spam or junk folder.
- Trigger a real site event, such as a form submission or account notification, using a test user.
- Confirm that the message’s sender, recipient, subject, and links are correct.
- If the message is missing, use the mail provider’s delivery or rejection information and Joomla/server logs to identify whether the failure occurred during connection, authentication, submission, or downstream filtering.
A transport test and an inbox test answer different questions: the first checks Joomla’s handoff, while the second checks what happened after the receiving system accepted or filtered the message.
Configuration checklist
- Path: System → Global Configuration → Server → Mail.
- Identity: From Email and From Name are set to the intended sender.
- Transport: PHP Mail, Sendmail, or SMTP is supported by the server.
- SMTP details: Host, port, security mode, authentication setting, username, and password match one provider configuration.
- Credentials: Gmail uses an app-specific password in the documented setup; other providers may require OAuth 2.0.
- Testing: Save, select Send Test Mail, and inspect the destination inbox and spam folder.
- Interpretation: A green test result confirms submission to the transport, not guaranteed inbox delivery.
What to use in common Joomla situations
| Situation | Practical starting point | Reason |
|---|---|---|
| Standard hosting with a documented local mail service | PHP Mail, then Sendmail if PHP Mail does not deliver | Joomla’s guide recommends trying the host-supported local transports first. |
| Localhost or development computer | SMTP with the same outgoing server and credentials used by your mail client | Local PHP Mail commonly lacks a configured relay. |
| Gmail account | SMTP at smtp.gmail.com using 465/SSL/TLS or 587/STARTTLS and an app-specific password | These are Joomla’s documented Gmail combinations. |
| Provider requiring modern sign-in | SMTP OAuth 2.0 where Joomla and the provider support it | Basic password authentication may be blocked by provider or organization policy. |
| Extension debugging | Make Send Test Mail succeed before examining extension code | This separates global transport problems from extension-specific problems. |
Frequently asked questions
Where do I configure Joomla email?
Open System → Global Configuration → Server and use the Mail section.
Which SMTP port should Joomla use?
Use the port specified by your provider. Port 25 is commonly associated with no security or STARTTLS, while 465 and 587 are commonly used for encrypted submission. The encryption setting must match the selected port.
Can I use my regular Gmail password?
The Joomla Gmail example uses an app-specific password. Enter it without spaces, even if Google displays it in groups.
Why does Joomla email fail on localhost?
Local PHP Mail often has no configured mail-transfer service. Use SMTP with the same outgoing host and credentials configured in your mail client, then check the inbox and spam folder.
Does a green Send Test Mail message guarantee delivery?
No. It indicates that Joomla handed the message to the configured transport. The receiving provider may still filter, defer, quarantine, or reject it.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
