Page tree
Skip to end of metadata
Go to start of metadata


This tutorial explains how to configure your WHM account so that users can receive push notifications for iOS mail. We introduced this feature in cPanel & WHM version 64. When users enable push notifications, they will receive updates when they receive a new messages in their Inbox.

You must export the Mail Apple Push Notification service (APNs) key, and then install the key on your WHM server to enable push notifications.

Receive push notifications for iOS mail


Create Key

To create the key, perform the following steps:

  1. Open the App Store application (app) via Finder (Applications >> App Store). You can also press Command + Space Bar then search for App Store .
  2. Ensure that you sign in.
  3. Search for macOS Server .
  4. Click the macOS Server icon, then click $19.99 (), then click Buy App ()
  5. Sign in, if necessary, then click Open ( ).
  6. Select This Mac from the Choose A Mac menu, then click Continue and then sign in if necessary.
  7. Select the Apple Push Notifications (APN) checkbox from the Settings menu.
  8. Enter your credentials.




Export key information

To export the key, perform the following steps:

  1. Open the Keychain Access app via Finder (Applications >> Utilities >> Keychain Access). You can also press Command + Space Bar then search for Keychain Access.
  2. Select System from the Keychains menu and Keys from the Category menu.
  3. control + left click (or right-click) the key () or certificate bundle ().
  4. Select Export "" … and then click Save to save it to your desired location.


    • You may need to enter your user credentials.
    • We strongly recommend that you password protect this file because it contains sensitive information.




Install the key

To install the key on WHM, perform the following steps:

  1. Navigate to WHM's Manage Service SSL Certificates interface (Home >>  Service Configuration >> Manage Service SSL Certificates).
  2. Select the iOS Mail Push Notifications tab.
  3. Click Upload PKCS #12 archive.
  4. Select your file.


    If you password protected your file, enter your password in the Input the password for the PKCS #12 archive: text box.

  5. Click Install.




Prepare device configuration

To ensure that the device itself is ready to receive push notifications you must restart the Mail app. To restart the Mail app, perform the following steps:

  1. Open the Mail app on your iOS device.

  2. Double-click the Home button.

  3. Swipe up to close the Mail app.

  4. In the Mail app, swipe down (to perform a manual fetch). For more information about how to close an app, read Apple's Force an app to close documentation.


  • If the above steps do not successfully initiate push notifications, you may need to restart your device.
  • To enable push notifications for the default email account, you must enter the username @ the server hostname on the client device, not @ the account's domain name. For example, enter username@server.hostname.tld, not For more information, read our Default Email Account documentation.




Lock screen notifications

To add preferred contacts to VIP to enable lock screen notifications, perform the following steps:

  1. Open the Mail app.

  2. Tap Mailboxes () in the top left corner.

  3. Tap the information () symbol from the VIP menu.
  4. Tap Add VIP….
  5. Select the contacts you wish to add to lock screen notifications.




 You must open TCP outbound traffic for port 2195 if your firewall restricts this port.


Specific attributes of this tutorial may vary with future versions. We used the following versions to capture this document's screenshots:

Program or Operating SystemVersion
OS X El Captain10.11.6
App Store2.1


Keychain Access9.0

Additional documentation