Connect Reeva to Thunderbird, Apple Mail, or Outlook

Screenshots from each client are coming — until then, the text steps below cover every field you need to fill in.

Reeva works with every standards-compliant mail client because it speaks the open protocols clients already understand: JMAP (native, fastest), IMAP4rev1 (every legacy client), and SMTP-AUTH for sending. This guide walks through the three most common desktop clients.

Server settings you’ll need

Keep these handy — every client asks for the same things:

Setting	Value
Incoming server (IMAP)	imap.reeva.me
Incoming port	993 (SSL/TLS)
Outgoing server (SMTP)	smtp.reeva.me
Outgoing port	465 (SSL/TLS) — or 587 STARTTLS
JMAP endpoint (JMAP-aware clients)	https://jmap.reeva.me/.well-known/jmap
Username	Your full Reeva address — e.g. [email protected]
Password	Your account password, or an app password from app.reeva.me → Security if you have 2FA enabled
Authentication	Normal password (over TLS)

With two-factor authentication on, you must use an app password — non-interactive clients can’t complete the 2FA prompt.

---

Mozilla Thunderbird

Thunderbird supports both JMAP (since v115) and IMAP. Auto-config picks JMAP first.

1. Open Account Setup

File → New → Existing Mail Account… (or click Set up another account on the home tab).

Fill in your name, email (e.g. [email protected]), and password. Click Continue. Thunderbird’s autoconfig fetches Reeva’s settings from autoconfig.reeva.me in a second or two — most users are done here.

2. (Only if autoconfig fails) Manual setup

Click Manual config and enter the IMAP/SMTP server details from the table above.

Press Re-test, then Done. Thunderbird verifies it can sign in and reach the server.

3. Done

Your mailbox appears in the folder pane. Inbox, Sent, Drafts and Archive sync immediately.

JMAP add-on (optional, faster): install JMAP for Thunderbird to switch from IMAP to JMAP. Sync becomes noticeably faster, especially on mailboxes with thousands of messages.

---

Apple Mail (macOS + iOS)

Apple Mail does not yet support JMAP. The IMAP + SMTP fallback works perfectly.

1. Add Account

macOS: Mail → Settings → Accounts → +, choose Other Mail Account… iOS: Settings → Mail → Accounts → Add Account → Other → Add Mail Account.

Enter your name, email and password. Tap Sign In.

2. Server info

Apple Mail will try autodiscover, then fall back to asking. If it asks, fill in:

• Account Type: IMAP
• Mail Server: imap.reeva.me
• SMTP Server: smtp.reeva.me
• Username: your full Reeva address
• Password: account or app password

3. Choose what to sync

Apple Mail asks which apps to enable. Mail is required; the rest are optional.

Calendar + Contacts: Apple Mail’s account doesn’t carry CalDAV / CardDAV. Add them separately under System Settings → Internet Accounts → Add Other Account → CalDAV Account / CardDAV Account, using caldav.reeva.me and carddav.reeva.me.

---

Microsoft Outlook (Windows + Mac)

Outlook for Windows (new) and classic Outlook both work over IMAP. JMAP is not supported by Outlook.

1. Add account

File → Add Account (classic) or Outlook → Settings → Accounts → + (new Outlook / Mac).

Enter your Reeva email. Tick “Let me set up my account manually” — this skips Outlook’s Microsoft-account autodiscover loop. Click Connect.

2. Pick IMAP, enter servers

Choose IMAP when Outlook asks for account type, then enter the server details:

• Incoming server: imap.reeva.me, port 993, SSL/TLS
• Outgoing server: smtp.reeva.me, port 465, SSL/TLS
• Username: your full Reeva address
• Password: account or app password

Click Connect.

3. Done

Outlook closes the dialog and your inbox appears in the folder list.

New Outlook on Windows can be flaky with non-Microsoft IMAP. If sign-in keeps failing, switch to classic Outlook (gear icon → toggle “Try the new Outlook” off) — it has a more reliable IMAP stack.

---

Troubleshooting

Symptom	Likely cause	Fix
”Authentication failed”	2FA enabled, used account password	Generate an app password at app.reeva.me → Security
Sign-in works, no mail appears	Client trying STARTTLS on port 993	Set incoming port to 993 with SSL/TLS (not STARTTLS)
Can receive, can’t send	Outgoing port blocked by ISP	Try port 587 with STARTTLS instead of 465 SSL/TLS
Certificate warning	Custom corporate root CA in front of you	Bypass for *.reeva.me or talk to your IT
Sync is slow	Using IMAP on a 10k+ inbox	Switch to a JMAP-capable client (Thunderbird + JMAP add-on, the Reeva apps) — see Why JMAP?

Related

• Install Reeva on your device — Dashboard + Webmail PWAs
• Why JMAP? — the modern protocol Reeva is built on
• Security & privacy — encryption, 2FA, app passwords