Set up Mail on cPanel
Put your company webmail on its own address, such as mail.yourcompany.com. One upload and a few settings in cPanel, then the setup page does the rest.
Before you start
| What | Where to get it |
|---|---|
| The cPanel login of the hosting account | From the hosting provider |
| The latest Mail release (zip) | From Yopdesign |
An admin mailbox, usually [email protected] | cPanel → Email Accounts (create it first if needed) |
The mail server name, usually mail.clientdomain.com | cPanel → Email Accounts → Connect Devices |
| PHP 8.1 or newer | cPanel → Select PHP Version (step 3) |
1. Make the subdomain
Mail runs on its own subdomain, in a folder outside public_html.
- cPanel → Domains → Create A New Domain.
- Domain:
mail.clientdomain.com. Untick “Share document root” if it is shown. - Document root:
mail.clientdomain.com/public, a folder in the home directory, not inside public_html. Submit. - cPanel → SSL/TLS Status → tick the new subdomain → Run AutoSSL. Wait for the green padlock, usually a minute or two.
2. Upload and unzip Mail
- cPanel → File Manager → open the folder
mail.clientdomain.comin the home directory (the one holdingpublic). - Upload the Mail zip into that folder.
- Right-click the zip → Extract into the same folder. You now have
core/,public/anddata/side by side. Answer “overwrite” if asked. - Delete the zip.
- Check cPanel → Domains → the subdomain → Manage: the document root must end in
/public.
Why outside public_html? Only public/ may be reachable from the web. core/ holds the settings and data/ holds profiles and logs, so they stay one level up.
3. Set PHP version and extensions
cPanel → Select PHP Version (on some hosts: MultiPHP Manager for the version and PHP Extensions for the rest).
| Setting | Value |
|---|---|
| PHP version | 8.1 or newer (8.3 or 8.4 recommended) |
| Extensions on | openssl, sodium, mbstring, iconv, zip, curl |
| upload_max_filesize | 25M (attachments up to 20 MB) |
| post_max_size | 30M |
| memory_limit | 128M or more |
No need to memorise this. The setup page in the next step checks every setting and says exactly what to change if one is missing.
4. Run the setup page
Open https://mail.clientdomain.com/. With no settings yet, Mail shows its setup page.
- Server check runs first: PHP, extensions, writable folders, HTTPS, document root, and the connection to Yopdesign’s update server. Fix anything red with the hint shown, then reload.
- Mail server is filled in from the page address. Change it if Connect Devices showed a different host. Ports stay at IMAP 993 and SMTP 465.
- Admin mailbox: type just the name, for example
noreply; the domain is added for you. Enter its password. - Moving from another Mail server? Choose its backup zip under “Moving from another server”. Otherwise skip it.
- Check and install. Mail signs in to that mailbox once to prove you own it, then saves its settings.
Done. That mailbox is now the admin, and only addresses on your domain can sign in. Sign in and Mail opens.
5. Connect cPanel
Needed for managing mailboxes and for “Change password”. Email itself works without it.
- In cPanel: Security → Manage API Tokens → Create.
- Name it
yop-mail, with no expiry date. Copy the token; cPanel shows it only once. - In Mail, signed in as the admin: Settings → Accounts → Connect to cPanel.
- Paste the token together with the cPanel username (the home folder name). The cPanel address is usually
https://mail.clientdomain.com:2083. - Connect. Mail tests the token before saving it, and the mailbox list appears.
Keep the token private. It can change every mailbox on that cPanel account, so paste it only into Mail’s own form, never into a chat or an email.
6. Finish
| Where | What to do |
|---|---|
| Settings → Login screen | Add the company logo, name and colour. See Brand the login screen. |
| Settings → Updates | Leave automatic updates on. See Updates. |
| Settings → Accounts | Create a mailbox for each person. See Manage mailboxes. |
| Phones | Share the Android app. See Android app. |
Updated 22 November 2026