cPanel Plugin

Warning: This plugin only supports AlmaLinux, Rocky Linux, and CloudLinux operating systems. Ubuntu is not yet supported.

​

Installing the cPanel Plugin

1. Ensure you have root access to your cPanel server.
2. Generate a smarthost (or use an existing one) in your JetEmail dashboard.
3. Open a terminal or SSH into your server.
4. Download the installation script and set the correct permissions:

curl -O https://cdn.jetemail.com/plugins/cpanel/install-cpanel.sh
chmod 755 install-cpanel.sh

5. Run the installation script (no inputs required):

./install-cpanel.sh

6. The script will install the JetEmail repository on your server.
7. After the repository is installed, you have two options to complete the configuration: Option A: Command Line Installation Run the jetemail-cpanel install command with your JetEmail credentials:
   jetemail-cpanel install --smtp-user USERNAME --smtp-pass PASSWORD
   
   Available options:
   • -u, --smtp-user <SMTP_USER>: Your JetEmail smarthost username (required, must not contain @ symbol)
   • -p, --smtp-pass <SMTP_PASS>: Your JetEmail smarthost password (required)
   • -d, --domain-lockdown: Add DNS TXT records for all domains (Domain Security)
   • -s, --add-spf: Add SPF include for JetEmail (email authentication)
   • -v, --verbose: Verbose output (use multiple times for more verbosity)
   • --port <PORT>: SMTP port — 25, 587, or 2525 (default: 587)
   • --skip-smtp-test: Skip SMTP connection test (use if network restrictions prevent connection testing)
   • --test-only: Test mode: only test SMTP connection, don’t install anything
   • -h, --help: Print help
   Examples:
   # Basic installation
   jetemail-cpanel install -u smarthostusername -p password
   
   # With domain security
   jetemail-cpanel install -u smarthostusername -p password -d
   
   # With SPF modification
   jetemail-cpanel install -u smarthostusername -p password -s
   
   # With both domain security and SPF
   jetemail-cpanel install -u smarthostusername -p password -d -s
   
   # Use port 2525 instead of the default 587
   jetemail-cpanel install -u smarthostusername -p password --port 2525
   
   # Test SMTP connection only
   jetemail-cpanel install -u smarthostusername -p password --test-only
   
   Option B: WHM Plugin Use the JetEmail plugin in WHM to complete the configuration through the web interface.

​

What the Plugin Does

1. Adds spf.jetsmtp.net to the additional hosts section of Exim configuration
2. Configures JetEmail’s inbound IP addresses in:
   • senderverifybypass list
   • trustedips list
3. If Domain Security is enabled (-d flag), adds a _jm TXT record to all domains for verification
4. If SPF modification is enabled (-s flag), enables and configures SPF records for all domains
5. Enables and configures DMARC records for all domains
6. Makes additional Exim configuration changes:
   • Enables SRS (Sender Rewriting Scheme)
   • Disables remote HELO checks

​

Uninstalling the cPanel Plugin

1. Ensure you have root access to your cPanel server.
2. Open a terminal or SSH into your server.
3. Remove the plugin using yum:

yum remove jetemail-cpanel

4. Remove the JetEmail repository file:

rm /etc/yum.repos.d/jetemail.repo

5. The plugin and all JetEmail configurations will be removed from your server.