Replacing hostname certificates for WHM and mail services

WHM and mail services use service certificates that may differ from a website’s Apache certificate. Replace the certificate for the actual connection hostname and selected services, keeping private-key material protected.

Prepare for the change

Confirm the hostname resolves correctly and obtain a valid matching certificate, private key and required chain. Save the existing working configuration and plan for brief management or mail-service reconnection.

01 Replace hostname certificates for WHM and mail services

  1. Open Manage Service SSL Certificates and inspect certificate names and expiry for the affected service.
  2. Use an appropriate existing certificate or the Install a New Certificate form. Select only the services intended to use that hostname certificate.
  3. Provide the matching certificate, private key and CA bundle through the secure administrator interface. Check their identity before installation.
  4. Install and complete any required service restart prompt, including the cPanel service daemon when applicable.
  5. Test new connections to WHM, SMTP and IMAP as relevant using the exact hostname customers or administrators configure. Verify trust, name coverage and expiry.

Confirm the expected result

The selected service should present the intended trusted certificate. A browser test against a website port does not substitute for testing the affected mail or management service.

If the change does not work

Reset Certificate creates a self-signed replacement and is not an ordinary trusted-certificate renewal button. If clients still warn, inspect the hostname, chain and actual certificate served rather than disabling certificate verification.

Can I use any customer’s website certificate for WHM?

Only a certificate covering the actual WHM hostname is appropriate. A certificate for a different domain will create a hostname mismatch even if a trusted authority issued it.

  • 0 Users Found This Useful
  • cpanel-whm, email
Was this answer helpful?

Related Articles

Using supported Apache include configuration in WHM

Use supported Apache includes for server configuration that WHM does not expose directly....

Reading AutoSSL logs for a domain-validation failure

AutoSSL logs show which names passed or failed domain-control validation during a certificate...

Reviewing the configured WHM AutoSSL provider and account policy

Manage AutoSSL controls the server’s certificate provider and which accounts participate in...

Changing a WHM server hostname with DNS and certificate checks

The server hostname identifies WHM and other system services and can appear in mail headers....

Tracing server-side delivery through WHM reports

WHM Mail Delivery Reports let an authorised administrator trace server-side message outcomes...