Connecting a mail client
Every Mailspace mailbox works in a desktop or phone mail app as well as in webmail. This guide shows where to find the settings your app asks for, and how to create an app password so one app gets its own credential instead of the mailbox password.
Before you start
- A mailspace that has finished setting up. If it hasn't, see Verifying your domain.
- A mailbox and its password. If nobody knows it, set a new one — see Managing mailboxes.
- To create, restrict or revoke an app password you need a role that can make changes in the workspace.
Find your settings
Most mail apps set themselves up if you enter the full email address and the mailbox
password. That needs the autoconfig and autodiscover CNAME records, shown on DNS
Records. We add them on DNS we host; if your DNS is elsewhere, add them at your DNS
provider. If your app can't set itself up, enter the settings by hand:
-
Open the mailspace. Choose Mailspace in the workspace sidebar, then the mailspace you want.
-
Find the Connection Info card on the Overview page. It lists Sign in, Incoming and Outgoing settings, each with a copy button.
-
Enter them in your mail app. The server name is
mail.followed by the mailspace's primary domain, and the same for every protocol.Block Protocol Port and encryption Incoming IMAP, syncs mail across devices 993 · SSL/TLSIncoming POP3, downloads to one device 995 · SSL/TLSOutgoing SMTP, sends your mail 465 · SSL/TLSor587 · STARTTLSChoose IMAP unless you have a reason not to. For outgoing mail, either port works.
-
Turn on sign-in for outgoing mail. The username is the full email address and the password is the mailbox password, for sending as well as receiving.
Use an app password
An app password is an extra credential on the same mailbox, with its own name, that you can revoke without touching anything else. It is recommended but optional: the mailbox password works in a mail app too.
-
Open the mailbox. Go to Mailboxes, open the row's actions menu and choose Edit mailbox. The mailbox must already exist.
-
Save any other changes first. Adding an app password reloads the page.
-
Add the password. Under Security → App passwords, click Add app password and name it after the app that will use it, for example Thunderbird on laptop.
-
Confirm your identity with your passkey or password if you are asked to.
-
Copy the password. It is shown only once. Paste it into your mail app, then click Done.
-
Sign in with it. Use your full email address as the username, with the same server and ports as above.
Lost an app password? Make another one.
An app password can't be shown again. Revoke it and add a replacement. Revoking takes effect immediately, and any app signed in with it stops connecting.
To limit an app password to known locations, use Restrict to IP addresses on its row and enter one or more addresses or ranges, separated by commas. An app connecting from anywhere else is refused with a permission or connection error, not a wrong-password message, so only use this for an app on a fixed address.
If the mail app won't connect
- Certificate warnings. On the Overview page, check the Mail Authentication card. If its Mail host row doesn't read ✓ Detected, click DNS Records and add the record it shows at your DNS provider.
- Sending fails but receiving works. Turn on sign-in for outgoing mail, with the same username and password.
- Still stuck. Sign in to Webmail with the same address and password. If webmail works, the problem is in the app's settings, or in an IP restriction on the app password or on the mailbox.
Next steps
- Add an app password per device, so losing a phone means revoking one password.
- Set up more mailboxes: Managing mailboxes.
- Not ordered a mailspace yet? See Ordering a Mailspace.