Configuring Outlook, Apple Mail & Thunderbird (IMAP/SMTP Settings)

Nyota Mail supports all standard desktop and mobile email clients—including Apple Mail (macOS & iOS), Microsoft Outlook, Mozilla Thunderbird, and Android Mail—using SSL-encrypted IMAP and SMTP protocols.

This guide provides the master connection settings, step-by-step setup guides for major email applications, and solutions for common authentication and port errors.

1. Master Server Settings Matrix

Use these exact connection parameters when configuring any email client or mobile device:

Incoming Mail (IMAP — Recommended)

IMAP synchronizes all folders, read states, and sent items across your phone, laptop, and webmail in real time:

Outgoing Mail (SMTP — Sending Messages)

(Note: ISP networks like Safaricom, Zuku, and Airtel block unencrypted Port 25. Always use Port 465 or 587).

2. Step-by-Step Client Setup Guides

A. Apple Mail (iOS / iPhone & iPad)

1. Open Settings on your iPhone/iPad 
   →→
    Mail 
   →→
    Accounts 
   →→
    Add Account.
2. Tap Other 
   →→
    Add Mail Account.
3. Enter your Name, full Email (jane@yourcompany.com), and Mailbox Password.
4. Select IMAP at the top.
5. Under Incoming Mail Server:
6. • Host Name: server.mxroute.com
   • User Name: Your full email address
   • Password: Your mailbox password
6. Under Outgoing Mail Server (SMTP):
7. • Host Name: server.mxroute.com
   • User Name: Your full email address
   • Password: Your mailbox password
7. Tap Next and save the account.

B. Microsoft Outlook (Windows & Mac)

1. Open Outlook 
   →→
    Go to File 
   →→
    Add Account.
2. Enter your email address (jane@yourcompany.com), select "Advanced options", and check "Let me set up my account manually".
3. Select IMAP.
4. Configure Server Details:
5. • Incoming Mail: Server server.mxroute.com | Port 993 | Encryption SSL/TLS
   • Outgoing Mail: Server server.mxroute.com | Port 465 | Encryption SSL/TLS
5. Enter your Mailbox Password and click Connect.

C. Mozilla Thunderbird

1. Open Thunderbird 
   →→
    Click Account Settings 
   →→
    Account Actions 
   →→
    Add Mail Account.
2. Enter your full name, email address, and mailbox password 
   →→
    Click Configure manually.
3. Set Incoming: Protocol IMAP | Hostname server.mxroute.com | Port 993 | SSL SSL/TLS | Authentication Normal password.
4. Set Outgoing: Hostname server.mxroute.com | Port 465 | SSL SSL/TLS | Authentication Normal password.
5. Click Re-test and then Done.

3. Common Pitfalls & How to Troubleshoot

Pitfall A: "Login Failed / Authentication Error"

• The Cause: Entering your master Nyota SSO account password (accounts.nyotaimara.com) instead of the specific mailbox password configured in mailadmin.
• The Resolution:
• 1. Log in to mailadmin.nyotaimara.com/mailboxes.
  2. Click on your mailbox and select "Reset Password".
  3. Enter the new mailbox password in your email client.

Pitfall B: "Certificate Name Mismatch Warning (yourcompany.com vs server.mxroute.com)"

• The Cause: Setting the incoming or outgoing hostname to mail.yourcompany.com instead of the canonical server hostname.
• The Resolution:
• • Change the server hostname in your email settings from mail.yourcompany.com to server.mxroute.com.
  • server.mxroute.com has a pre-installed, trusted 2048-bit wildcard SSL certificate that eliminates all security warnings.

Pitfall C: "Cannot send email (Outgoing SMTP Timeout)"

• The Cause: Your email app disabled "Outgoing Server Authentication" or attempted to use blocked Port 25.
• The Resolution:
• • In your account settings, check the box for "My outgoing server (SMTP) requires authentication" and select "Use same settings as incoming server".
  • Ensure the Outgoing Port is set to 465 with SSL/TLS.

Related Support Guides & Links

• Custom Domain DNS Setup Guide (MX, SPF, DKIM, DMARC)
• Zero-Downtime Email Migration Guide
• Access Webmail Client Directly