> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wazobiamail.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect email apps

> Read and send your WazobiaMail address from Gmail, Thunderbird, Outlook or Apple Mail — with the exact settings and step-by-step instructions.

# Connect email apps

You do not have to use the WazobiaMail website to read and send your mail. Your
WazobiaMail address works in almost every email app on the market, including
**Gmail**, **Thunderbird**, **Outlook** and **Apple Mail**. This page shows
every setting and the steps for each app, in plain language.

## Before you start: get your settings from the dashboard

Open the WazobiaMail dashboard at [https://app.wazobiamail.com](https://app.wazobiamail.com), go to
**Mailboxes**, find the address you want to use, open the row's actions and
choose **Email client setup** or **Copy setup details**. The dialog shows the
hostname, port and encryption for your mailbox, and has buttons to enable SMTP
sending access and reset the password.

![The WazobiaMail inbox shown at the same time on a laptop and on a phone](https://mintcdn.com/bonifade-technologies/cx9v-MkchH9WKHTe/images/webmail/mail-devices.webp?fit=max\&auto=format\&n=cx9v-MkchH9WKHTe\&q=85\&s=60693e428d59b93a92baa44116b55ef3)

Use these settings in the table below — they are the defaults for hosted
mailboxes, and the dashboard always shows your own live values:

| What for | Server name | Port | Security |
| - | - | - | - |
| **Sending (SMTP)** | `send.wazobiamail.app` | `587` | STARTTLS |
| Sending (SMTP, alternative) | `send.wazobiamail.app` | `465` | SSL/TLS |
| **Receiving (IMAP)** | `mail.wazobiamail.app` | `993` | SSL/TLS |
| Receiving (POP3) | `mail.wazobiamail.app` | `995` | SSL/TLS |

Two rules apply to every app:

* The **username is your full email address** (for example `ada@yourcompany.com`).
* The **password is your mailbox password** — the same one for sending and
  receiving. It is not the password of your WazobiaMail dashboard account, and
  it is never your API key.

> [!NOTE]
>
> **IMAP or POP3?** Choose **IMAP** when the mailbox is used from more than one
> device (a computer and a phone, or two computers): folders and read/unread
> state stay the same everywhere. Choose **POP3** only when one single device
> downloads everything. WazobiaMail offers both — when an app asks, prefer IMAP.

> [!WARNING]
>
> Sending through SMTP requires an active paid subscription and SMTP access
> enabled for the mailbox (the checkbox in the same setup dialog). Receiving
> mail works on every plan.

## Mozilla Thunderbird

Thunderbird is the easiest app to connect — it finds the settings itself.

1. Open Thunderbird and choose **Set Up Your Existing Email Address**
   (or **Add a mail account** from the app menu).
2. Enter your name (as recipients should see it), your **full email address**
   and your **mailbox password**. Choose *Remember password* and select
   **Continue**.
3. Thunderbird looks up the settings automatically. If it asks, keep
   **IMAP** selected and select **Done**.
4. If automatic lookup fails, select **Configure manually** and fill in the
   table above: incoming server `mail.wazobiamail.app`, port `993`, SSL/TLS,
   username = your email address; outgoing server `send.wazobiamail.app`, port
   `587`, STARTTLS, authentication = normal password.
5. Thunderbird may ask you to confirm the security certificates. Accept and
   confirm — the connection is encrypted.
6. Select **Done**. Your inbox appears, and sending and receiving both work.

## Gmail (in the browser)

A personal Gmail account can display your WazobiaMail mail in the same Gmail
inbox. It does this in two parts, configured separately: **receiving** (Gmail
fetches new mail from your mailbox) and **sending** (replies go out through
WazobiaMail, so recipients see your WazobiaMail address, not a gmail.com one).

**Part 1 — receive your mail in Gmail:**

1. In Gmail, select the gear icon → **See all settings** → **Accounts and
   Import**.
2. Under *Check mail from other accounts*, select **Add a mail account**.
3. Enter your **full WazobiaMail address** and select **Next**.
4. Select **Import emails from my other mail account (POP3)** and **Next**.
5. Fill in:
   * Username: your full email address
   * Password: your mailbox password
   * POP Server: `mail.wazobiamail.app`
   * Port: `995`
   * Tick **Always use a secure connection (SSL)**.
6. Gmail asks what to do with the messages on the other server — tick **Leave
   a copy on the server** if you still want to read them on your phone or in
   other apps, then select **Add Account**.

**Part 2 — send from your WazobiaMail address in Gmail:**

1. Back on **Accounts and Import**, under *Send mail as*, select **Add another
   email address**.
2. Enter your name and your WazobiaMail address, tick **Treat as an alias**, and
   select **Next Step**.
3. Fill in **Send through SMTP servers**:
   * SMTP Server: `send.wazobiamail.app`
   * Port: `587`
   * Username: your full email address
   * Password: your mailbox password
   * Select **Secured connection using TLS**.
4. Select **Add Account**, then click the verification link in the confirmation
   email that arrives in your inbox.

> [!WARNING]
>
> Gmail starts fetching mail from the moment you add the account — it does not
> import messages that arrived before. Gmail also checks for new mail on its own
> schedule, so mail can arrive a few minutes later than in the WazobiaMail
> inbox. For live, full two-way synchronisation of folders, Thunderbird, Apple
> Mail or Outlook with IMAP is the better choice.

## Apple Mail (Mac, iPhone, iPad)

1. Open **Mail** → **Settings** (on iPhone/iPad: **Settings** → **Mail** →
   **Accounts**) and choose **Add Account** → **Other Mail Account**.
2. Enter your name, your **full email address** and your **mailbox password**,
   then select **Sign In** (or **Next**).
3. Mail normally finds the rest. If it asks for details, fill in:
   * Incoming Mail Server: `mail.wazobiamail.app`
   * Outgoing Mail Server: `send.wazobiamail.app`
   * Username (both rows): your full email address
   * Password (both rows): your mailbox password
4. IMAP is used automatically, so folders stay in step between your Mac and
   your phone.

## Outlook (Windows)

**Classic Outlook (installed from Microsoft 365 or Office):**

1. Open Outlook → **File** → **Add Account**.
2. Enter your full email address and select **Connect**.
3. If Outlook does not set itself up, select **Advanced options** first, tick
   **Let me set up my account manually**, and choose **IMAP**.
4. Fill in the settings table above: incoming `mail.wazobiamail.app`, port
   `993`, SSL/TLS; outgoing `send.wazobiamail.app`, port `587`, STARTTLS,
   username and password in both rows = your email address and mailbox
   password. Select **Next**, enter the password if asked, and connect.

**New Outlook (the blue icon without the classic ribbon):**

1. Select the gear icon → **Accounts** → **Add account** (or **Your accounts**
   → **Add account**).
2. Because new Outlook prefers cloud providers, choose **Advanced** / **IMAP**
   when the provider list appears.
3. Enter the incoming and outgoing server settings from the table, your full
   email address as username, and your mailbox password.

## Microsoft Outlook on the web, Yahoo and other providers

Email providers that only allow their own addresses (Outlook.com, Yahoo) cannot
display another provider's incoming mail; they only add a different **sending**
address. If your app is not listed here, the settings in the table are all you
need — nearly every app asks for exactly: *server, port, security type,
username, password* for IMAP and SMTP.

## Troubleshooting

| Problem | Cause and fix |
| - | - |
| "Wrong password" or repeated login prompt | The password was reset or mistyped. Reset it from the dashboard (**Mailboxes** → **Email client setup**) and type the new one into the app. |
| Mail receives but sending fails with "authentication" or "relaying refused" | SMTP sending needs your subscription active and SMTP access enabled for the mailbox in the setup dialog. Also check you used your full email address as username and port `587` with STARTTLS. |
| "Cannot connect to server" or a certificate warning | Check the exact server names and port from the table. A misspelled server name is the most common cause. |
| Mail arrives on one device but not another | One of the devices was set up with POP3, which downloads and hides mail. Change that device (or all devices) to IMAP. |
| Everything worked before, now neither sending nor receiving works | The mailbox password changed. Update the saved password in the app — each app has "Saved passwords" or an account's security options. |

## Next steps

> [card] [Using your inbox](https://docs.wazobiamail.com/docs/guides/using-your-inbox.md)
>
> Read, send and organise mail on the WazobiaMail website.

> [card] [Hosted mailboxes](https://docs.wazobiamail.com/docs/guides/mailboxes.md)
>
> Create addresses and reset passwords from the dashboard.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.