Skip to main content
Add a hosted mailbox to the mail app you already use. Every mailbox works over IMAP (to read mail) and SMTP (to send it).
Before you start: you need the mailbox’s full address and its password. The password is shown once, when the mailbox is created or its password is reset. If nobody saved it, reset it. See Reset a password. The mailbox’s status must be Active.

​
Server settings

Both ports use TLS from the moment the connection opens. Don’t choose STARTTLS or “None”. When a client asks for the account type, choose IMAP.

​
Folder names

The server’s special folders are called Sent Items, Deleted Items and Junk Mail. If your client asks where to keep sent, deleted or junk messages, choose these. Otherwise your sent mail can end up in a folder that other devices don’t show.
Don’t let your client auto-fill these. If you published the optional autodiscovery records, some clients read them and fill in hostnames on prod.brudcast.org — which aren’t serving mail today, so the connection fails. If you see anything other than mail.brudcast.io, replace it with the values in the table above. See The record set.

​
Add the mailbox to your app

Menu names vary a little between app versions. If something has moved, look for the option to add an account “manually” or to add an “other” account type.
On a Mac
  1. Open Mail. From the menu bar, choose Mail > Add Account.
  2. Choose Other Mail Account, then Continue.
  3. Enter your name, the full email address and the mailbox password, then select Sign In.
  4. If Mail can’t find the settings, it asks for more details. Set Account Type to IMAP, and both Incoming Mail Server and Outgoing Mail Server to mail.brudcast.io. Enter the full address as the user name, then select Sign In.
  5. To check the ports, open Mail > Settings > Accounts, select the account and open Server Settings. Turn off Automatically manage connection settings for incoming and outgoing mail, then set port 993 and 465 with Use TLS/SSL on.
On an iPhone or iPad
  1. Open Settings, go to Mail, then Mail Accounts (on some versions, Accounts).
  2. Select Add Account > Other > Add Mail Account.
  3. Enter your name, the full email address and the mailbox password, then select Next.
  4. Choose IMAP. Under both Incoming Mail Server and Outgoing Mail Server, enter mail.brudcast.io as the host name, the full address as the user name, and the password.
  5. Select Next, then Save.
  6. To check the ports, open the account, then Account > Advanced. Incoming should use SSL on port 993. Under Outgoing Mail Server > SMTP, the primary server should use SSL on port 465.

​
Troubleshooting

Why: the username must be the full email address, not just the part before the @. The password may have been reset since you saved it, or the mailbox may be suspended or still Provisioning.Fix: check the mailbox’s status on the domain’s Mailboxes tab. If it’s Active and you don’t have the current password, select Reset Password in its actions menu and use the new one.
Why: the port or security setting doesn’t match, or your network blocks ports 993 or 465.Fix: set IMAP to port 993 and SMTP to port 465, both with SSL/TLS. Try another network to rule out a firewall.
Why: the app is saving sent mail to its own folder instead of the server’s Sent Items.Fix: in the app’s account settings, set the folder for sent messages to Sent Items. Do the same for Deleted Items and Junk Mail.
Why: inbound delivery depends on your domain’s MX record.Fix: open the domain under Mailboxes and read the routing panel on its Mailboxes tab. See How mail reaches a mailbox.

Reset a password

Replace a password nobody saved.

Aliases

Deliver more addresses to one mailbox.

Mail domain records

The MX record that routes inbound mail.