Hosted Push Notification Service

Securing your Mattermost Push Notification Service

When using Mattermost mobile apps in the Apple App Store and Google Play, purchase an annual subscription to Mattermost Enterprise Edition E10 or higher to receive access to our Hosted Push Notification Service (HPNS).

Our Hosted Push Notification Service offers:

  • Access to a publicly-hosted Mattermost Push Notification Service (MPNS) offering an explicit privacy policy where the contents of unencrypted messages are not examined or stored.

  • Encrypted TLS connections between HPNS and Apple Push Notification Services, HPNS and Google’s Firebase Cloud Messaging service, and HPNS and your Mattermost server.

  • Production-level uptime expectation.

After purchasing a subscription to Mattermost Enterprise Edition E10 or higher from Mattermost, Inc. follow the instructions below to set up and test your system.

Note

  • Both TPNS and HPNS only work with the Mattermost Apple App Store and Google Play apps. If you have compiled the apps yourself, you must also host your own Mattermost push proxy server. See our FAQ on how push notifications work for more details. Our push proxy server is available on GitHub.

  • You must ensure that the push proxy can be reached on the correct port. For HPNS, it’s port 443 from the Mattermost server, and for TPNS, it’s port 80. If you host your own proxy server, the default port is 8086.

  • Mattermost, Inc. also offers a free basic hosted service for testing called the Test Push Notification Service (TPNS). It does not offer production-level uptime service level agreements (SLAs).

Setting up HPNS Push Notifications in Enterprise Edition

Follow these steps to set up HPNS:

  1. Follow the instructions to install or upgrade to Enterprise Edition.

  2. Go to System Console > Environment > Push Notification Server.

  3. Set Enable Push Notifications to Use HPNS connection with uptime SLA to send notifications to iOS and Android apps. Note that this option is only available in Enterprise Edition.

../_images/mobile_hpns.png
  1. Review the Mattermost Terms of Service and the Mattermost Privacy Policy, then select the box “I understand and accept the Mattermost Hosted Push Notification Service Terms of Service and Privacy Policy” to acknowledge that you understand the terms of use.

Note

The default Push Notification Server address is https://push.mattermost.com and the server is hosted inside the United States. Mattermost also offers a push notification server hosted in Germany. If you wish to use that server, please update the Push Notification Server address to https://hpns-de.mattermost.com/.

  1. Select Save

After setup, test push notifications to confirm they are working.