First-time setup

Configure Mail Manager

Connect the application database and one cPanel account, then create the dashboard administrator.

Server requirements

Every required PHP capability and application directory must be available.

Ready

PHP 8.2 or newer

PDO MySQL extension

cURL extension

JSON extension

mbstring extension

OpenSSL extension

Writable config directory

Writable storage directory

Application

Branding, URL, environment, and local time zone.

Application name

Application base URL OptionalLeave blank when installed at the domain root.

Environment

Time zoneUse an IANA name such as Africa/Cairo.

MySQL database

Use a dedicated MySQL 8+ database and user.

Database host

Port

Database name

Database user

Database password

cPanel mail integration

Use a cPanel-account API token, never WHM root credentials.

cPanel hostname

Secure port

cPanel account username

Fallback mail hostname OptionalUsed only if cPanel client settings omit hostnames.

cPanel API token

The token is written only to protected server-side configuration.

Managed domains

Choose exactly which domains this dashboard may display or modify.

Enter the cPanel credentials, then load the available domains.

Optional fallback mail ports

Configure these only when cPanel does not return usable client settings.

IMAP SSL/TLS port

POP3 SSL/TLS port

SMTP SSL/TLS port

Alternative SMTP port

Encryption label

Use safe mock modeAvailable only in Development. No real cPanel changes occur.

Mock domains

Dashboard administrator

Create the separate management account used only by this application.

Username

Display name

Contact email Optional

Password

Password strength: Not entered

Confirm password

The installer locks after success.To reinstall later, a server administrator must deliberately remove the lock and configuration.