# Custom IMAP Integration Guide

### 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](https://yey.email/inbox/settings)
2. Click the **"Custom IMAP"** button
3. Fill in the required information:
   * **Email Address**: Your full email address (e.g., `yourname@provider.com`)
   * **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!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.yey.email/inbox/custom-imap-integration-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.