Custom IMAP Integration Guide

Setting Up Any Email Provider with yey.email

Step 1: Gather Your Email Server Information

Before connecting, you'll need to find your email provider's IMAP settings. Common providers:

Popular Email Providers:

• ProtonMail Bridge: 127.0.0.1:1143 (requires ProtonMail Bridge app)

• iCloud: imap.mail.me.com:993 (SSL/TLS)

• Zoho Mail: imap.zoho.com:993 (SSL/TLS)

• FastMail: imap.fastmail.com:993 (SSL/TLS)

• Tutanota: Not supported (no IMAP access)

How to Find Your Settings:

1. Check your email provider's support documentation

2. Look for "IMAP settings" or "email client configuration"

3. Common IMAP ports: 993 (SSL/TLS) or 143 (STARTTLS)

Step 2: Connect Custom IMAP to yey.email

1. Navigate to yey.email Inbox Settings

2. Click the "Custom IMAP" button

3. Fill in the required information:

   • Email Address: Your full email address (e.g., [email protected])

   • IMAP Server: Server hostname (e.g., imap.provider.com)

   • Port: Usually 993 for SSL/TLS or 143 for STARTTLS

   • Security: Choose SSL/TLS (Port 993) or STARTTLS (Port 143)

   • Password: Your email account password or app-specific password

Step 3: Authentication Setup

For providers requiring app passwords:

1. Enable two-factor authentication on your email account

2. Generate an app-specific password in your account security settings

3. Use the app password instead of your regular password

For providers with regular passwords:

1. Simply use your normal email password

2. Ensure IMAP access is enabled in your account settings

Step 4: Test Connection

1. Click "Add Account" to test the connection

2. If successful, your emails will start syncing immediately

3. If connection fails, double-check your server settings and credentials

Step 5: Set Up Encryption (Optional but Recommended)

1. Go to your yey.email Dashboard

2. Click "Generate Encryption Keys" if you haven't already

3. Copy your public key address

4. Share your email address and public key with contacts who want to send you encrypted emails

What You Get

✅ Universal Compatibility: Connect virtually any email provider ✅ Flexible Configuration: Manual control over all connection settings ✅ End-to-End Encryption: Add security to any email provider ✅ Provider Independence: Keep using your preferred email service ✅ Conversation Threading: Gmail-style organization for any provider

Common IMAP Settings Reference

Provider	IMAP Server	Port	Security
iCloud	imap.mail.me.com	993	SSL/TLS
Zoho	imap.zoho.com	993	SSL/TLS
FastMail	imap.fastmail.com	993	SSL/TLS
ProtonMail	127.0.0.1	1143	STARTTLS*

*ProtonMail requires the ProtonMail Bridge application

Troubleshooting

• Connection Failed: Verify IMAP is enabled in your email provider's settings

• Authentication Error: Check if your provider requires app-specific passwords

• SSL Errors: Try switching between SSL/TLS and STARTTLS security options

• Port Issues: Confirm the correct IMAP port with your provider's documentation

Your custom email provider is now connected to yey.email and ready for secure, encrypted communication!