Set up email in BlueMail
Add a cPanel mailbox to BlueMail on Android, iOS, Windows, Mac or Linux, with the manual IMAP settings and the right notification method.
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.
If the mailbox does not exist yet, create it first.
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.
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.
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.
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
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.
- Open BlueMail. If this is your first account, select Continue, then Having trouble? Manual Setup. Otherwise go to Settings → Accounts → Add Account.
- On the provider selection screen, select Manual Setup at the bottom.
- Select IMAP.
- Enter your full email address and mailbox password.
- Under the incoming server, enter
mail.example.com, port993, security SSL/TLS. - Under the outgoing server, enter
mail.example.com, port465, security SSL/TLS. - Confirm the username on both servers is your full email address. BlueMail
sometimes pre-fills the outgoing username with only the part before the
@. - Enter the name you want shown on messages you send, then finish setup.
Your messages begin downloading.
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.
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.
Check it worked
- Send a message from BlueMail to an address you can read elsewhere.
- Confirm it arrives, and that the sender shows as your own domain.
- 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
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.
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".
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.
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.
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 provides.