# Set up email in BlueMail
Source: https://docs.webgee.com/en/email/bluemail



Add a mailbox you created in cPanel to BlueMail. Applies to shared, reseller and
Premium hosting, on all five platforms BlueMail runs on — Android, iOS, Windows,
macOS and Linux.

The setup screens are close enough across platforms that one procedure covers
them all. Where they differ is in **how new mail reaches you**, which is worth a
decision rather than the default — see below.

You need two things before you start:

* Your **full email address**, including the domain — `you@example.com`.
* Your **mailbox password**, set when the mailbox was created. It is not your
  WebGee account password. If you do not have it, reset it rather than guess —
  see [Change a mailbox password or quota](/en/email/how-to-change-your-email-account-password-or-mailbox-quota-in-cpanel).

If the mailbox does not exist yet,
[create it first](/en/email/how-to-create-email-accounts-in-cpanel).

## The settings BlueMail needs [#the-settings-bluemail-needs]

Replace `example.com` with your own domain throughout.

| Setting  | Incoming (IMAP)       | Outgoing (SMTP)       |
| -------- | --------------------- | --------------------- |
| Server   | `mail.example.com`    | `mail.example.com`    |
| Port     | `993`                 | `465`                 |
| Security | SSL/TLS               | SSL/TLS               |
| Username | `you@example.com`     | `you@example.com`     |
| Password | your mailbox password | your mailbox password |

Port `587` with STARTTLS is an equally valid outgoing alternative, and is worth
trying if `465` fails — see
[SSL/TLS and STARTTLS explained](/en/email/email-what-is-the-difference-between-ssl-tls-and-starttls).

Choose **IMAP**, not POP3. IMAP keeps mail on the server so every device shows
the same mailbox; POP3 downloads messages to one device and removes them from
the server. POP3 also rules out BlueMail's push notifications entirely, which is
a second reason to avoid it here.

<Callout type="info">
  The username is the **full address**, not the part before the `@`. Entering
  just the local part is the single most common reason BlueMail reports the
  password as incorrect when the password is fine.
</Callout>

To confirm these values for a specific mailbox, open **Email Accounts** in
cPanel — type `Email Accounts` into the search box at the top — select
**Connect Devices** beside the mailbox, and read the **Secure SSL/TLS Settings**
column.

## Add your mailbox [#add-your-mailbox]

Go straight to manual setup. BlueMail's provider list is built around the large
consumer providers, and its automatic detection has no reliable way to find the
settings for a self-hosted domain.

1. Open BlueMail. If this is your first account, select **Continue**, then
   **Having trouble? Manual Setup**. Otherwise go to
   **Settings → Accounts → Add Account**.
2. On the provider selection screen, select **Manual Setup** at the bottom.
3. Select **IMAP**.
4. Enter your full email address and mailbox password.
5. Under the incoming server, enter `mail.example.com`, port `993`, security
   **SSL/TLS**.
6. Under the outgoing server, enter `mail.example.com`, port `465`, security
   **SSL/TLS**.
7. Confirm the username on **both** servers is your full email address. BlueMail
   sometimes pre-fills the outgoing username with only the part before the `@`.
8. Enter the name you want shown on messages you send, then finish setup.

Your messages begin downloading.

## Choose how new mail arrives [#choose-how-new-mail-arrives]

BlueMail offers five notification methods at
**Settings → Notifications → \[your account] → Push or Fetch**. It shows only the
ones your account type supports, and the right choice for a cPanel mailbox
depends on your platform.

| Method             | What it does                                                           |
| ------------------ | ---------------------------------------------------------------------- |
| **Direct Push**    | Instant, over a direct connection to `mail.example.com`. Android only. |
| **Instant Push**   | Instant, routed through BlueMail's own push service. Android and iOS.  |
| **Frequent Fetch** | Checks on a schedule. **Fetch Interval** sets how often, on Android.   |
| **No Push**        | No notifications; mail updates when you open the app.                  |
| **Manual**         | Refreshes only when you ask it to.                                     |

**On Android, choose Direct Push.** It gives you instant mail with your device
talking to the mail server directly, and nothing in between.

**On iOS, choose between Instant Push and Frequent Fetch**, having read the
warning below. Direct Push is not available on iOS.

**On Windows, macOS and Linux**, BlueMail states it does not process your
credentials at all, so this consideration does not arise.

<Callout type="warn">
  A cPanel mailbox authenticates with a password — there is no OAuth for
  BlueMail to use instead. On **iOS**, enabling **Instant Push** therefore means
  BlueMail's push service holds your mailbox credentials, encrypted, so it can
  watch the mailbox on your behalf. BlueMail states the messages themselves are
  relayed and not stored.

  That is a reasonable trade for instant mail on a personal account. For a
  mailbox carrying client or commercial correspondence, check it against your
  own confidentiality obligations first, and use **Frequent Fetch** if it does
  not pass.
</Callout>

## Check it worked [#check-it-worked]

1. Send a message from BlueMail to an address you can read elsewhere.
2. Confirm it arrives, and that the sender shows as your own domain.
3. Reply from that other account and confirm the reply reaches BlueMail.

Test both directions. Sending and receiving are separate connections with
separate settings, so a one-way test tells you nothing about the half that is
broken.

## If it does not work [#if-it-does-not-work]

**BlueMail keeps rejecting the password.** The username must be the full email
address, on the outgoing server as well as the incoming one — step 7 above.
If it is, sign in to webmail at `https://webmail.example.com` with the same
details. If webmail rejects them too, the password is wrong and resetting it in
cPanel is the fix. If webmail accepts them, the fault is in BlueMail's settings.

**A certificate warning appears.** The certificate does not cover
`mail.example.com`. This happens on alias (parked) domains, and while DNS is
still pointing at the server. Do not dismiss it permanently — use the server's
own hostname or `webmail.webgee.com` instead, both of which carry valid
certificates and work with any mailbox. See
[Why AutoSSL skips some service subdomains](/en/security-ssl/why-autossl-doesnt-cover-service-subdomains-for-alias-domains-in-cpanel).

**Mail arrives but will not send.** Check the outgoing server has authentication
switched on and set to the same credentials as incoming. If the port is `25`,
change it — most mobile networks and home ISPs block `25` outright. Try `465`,
then `587`. See
[Fix "550 Please turn on SMTP Authentication"](/en/email/understanding-and-resolving-the-550-please-turn-on-smtp-authentication-error).

**Automatic setup picked the wrong settings.** BlueMail matched your domain to a
consumer provider. Remove the account and add it again through **Manual Setup**,
as above, rather than correcting the detected values one at a time.

**Notifications stop after a while on Android.** Battery optimisation is
suspending the app. Exclude BlueMail from battery optimisation in Android's
settings — the exact path varies by manufacturer, and Samsung, Xiaomi and Huawei
devices are the usual offenders.

**Nothing notifies, though mail is arriving.** BlueMail notifies on messages
landing in the **Inbox** only. A cPanel filter or a spam rule that files mail
straight into another folder delivers it silently — see
[Spam and virus filtering](/en/email/spam-and-virus-filtering).

**Sending works, then stops for an hour.** You have hit the hourly outbound
limit for the domain, which counts everything the account sends including your
website's forms — see [Email sending limits](/en/email/email-sending-limits).

## Calendars and contacts [#calendars-and-contacts]

A cPanel mailbox is mail only. There is no calendar or contact server behind it,
so BlueMail's calendar holds whatever is local to the device and syncs nothing
back. If you need shared calendars and contacts across devices, that is what
[WebGee Workspace](/en/email/what-is-webgee-workspace-email-hosting) provides.

## Related [#related]

* [Email server settings](/en/email/manual-configuration)
* [Create an email account](/en/email/how-to-create-email-accounts-in-cpanel)
* [Set up email on Android](/en/email/android)
* [SSL/TLS and STARTTLS explained](/en/email/email-what-is-the-difference-between-ssl-tls-and-starttls)