SMTP must be configured for AlgoSphere to send emails. Navigate to Setup → Settings → Email to configure.
Outlook / Office 365 standard SMTP is not supported. Use Microsoft Azure OAuth 2 instead.
Mail Engine
AlgoSphere supports two email libraries:
- PHPMailer (recommended) — industry-standard PHP email library
- CodeIgniter Mail — the framework's built-in mailer
Email Encryption & Port
| Encryption | Port | Use when… |
|---|---|---|
| SSL | 465 | Standard secure SMTP |
| TLS | 587 | Modern STARTTLS connection |
| None | 25 | Unencrypted (not recommended) |
Do not set SSL on port 587, or TLS on port 465. Each encryption type requires its specific port.
Gmail Configuration
Gmail SSL (port 465)
Encryption : SSL
SMTP Host : smtp.gmail.com
SMTP Port : 465
SMTP Email : youremail@gmail.com
Password : [your App Password]Gmail TLS (port 587)
Encryption : TLS
SMTP Host : smtp.gmail.com
SMTP Port : 587
SMTP Email : youremail@gmail.com
Password : [your App Password]For Gmail, use an App Password instead of your regular Google Account password. Generate one at myaccount.google.com/apppasswords.
AWS SES Setup
Encryption : TLS
SMTP Host : email-smtp.us-east-1.amazonaws.com
SMTP Port : 587
SMTP Email : your-verified@domain.com
Password : [your AWS SMTP password]Ensure the sending email address is verified in your AWS SES console and your account is out of sandbox mode for production use.
Testing Your SMTP Setup
After saving, scroll down to Send Test Email on the same settings page. Enter your email and click submit. If successful you'll receive a test email within moments.
Troubleshooting
Connection Refused (Error 111)
Your hosting provider may be blocking outbound SMTP ports (465/587). Contact your host to open these ports, or switch to AWS SES or Google OAuth 2.0.
Settings Not Saving
A firewall (mod_security or Suhosin) may be blocking HTML content in the predefined header/footer fields. Try clearing those fields and saving first.
Emails Going to Spam
Ensure your domain has valid SPF, DKIM, and DMARC DNS records. Use a dedicated sending domain for transactional email at scale.
Email Queue
AlgoSphere queues emails and sends them via the cron job. Navigate to Setup → Email Queue to view pending, sent, and failed emails. Failed emails can be retried from this page.