Discuss a Project

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.

MailAbout 15 minutes · 6 steps

Before you start

WhatWhere to get it
The cPanel login of the hosting accountFrom 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.comcPanel → Email Accounts → Connect Devices
PHP 8.1 or newercPanel → Select PHP Version (step 3)

1. Make the subdomain

Mail runs on its own subdomain, in a folder outside public_html.

  1. cPanel → Domains → Create A New Domain.
  2. Domain: mail.clientdomain.com. Untick “Share document root” if it is shown.
  3. Document root: mail.clientdomain.com/public, a folder in the home directory, not inside public_html. Submit.
  4. 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

  1. cPanel → File Manager → open the folder mail.clientdomain.com in the home directory (the one holding public).
  2. Upload the Mail zip into that folder.
  3. Right-click the zip → Extract into the same folder. You now have core/, public/ and data/ side by side. Answer “overwrite” if asked.
  4. Delete the zip.
  5. 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).

SettingValue
PHP version8.1 or newer (8.3 or 8.4 recommended)
Extensions onopenssl, sodium, mbstring, iconv, zip, curl
upload_max_filesize25M (attachments up to 20 MB)
post_max_size30M
memory_limit128M 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.

  1. 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.
  2. 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.
  3. Admin mailbox: type just the name, for example noreply; the domain is added for you. Enter its password.
  4. Moving from another Mail server? Choose its backup zip under “Moving from another server”. Otherwise skip it.
  5. 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.

  1. In cPanel: Security → Manage API Tokens → Create.
  2. Name it yop-mail, with no expiry date. Copy the token; cPanel shows it only once.
  3. In Mail, signed in as the admin: Settings → Accounts → Connect to cPanel.
  4. Paste the token together with the cPanel username (the home folder name). The cPanel address is usually https://mail.clientdomain.com:2083.
  5. 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

WhereWhat to do
Settings → Login screenAdd the company logo, name and colour. See Brand the login screen.
Settings → UpdatesLeave automatic updates on. See Updates.
Settings → AccountsCreate a mailbox for each person. See Manage mailboxes.
PhonesShare the Android app. See Android app.

Updated 22 November 2026

  • Free consultation
  • No obligation

Have an idea for a website, app or system? Let's build it together.

Tell us what you need. We reply with a clear scope, cost estimate and schedule.

  • 500+clients since 2009
  • 17 yearsof experience
  • 5.0on Google