From 4ad38681f75cf08eeb4d66c21d8f39d2ff93106a Mon Sep 17 00:00:00 2001 From: Marco Date: Mon, 27 Jul 2026 15:13:03 +0200 Subject: [PATCH 1/2] Document HPNS regional URLs (Global, US, EU, Japan) and remove stale single-URL references --- ...fication-server-configuration-settings.rst | 25 ++++++++++++------- .../mobile/mobile-troubleshooting.rst | 6 ++--- .../troubleshoot-notifications.rst | 2 +- 3 files changed, 20 insertions(+), 13 deletions(-) diff --git a/source/administration-guide/configure/push-notification-server-configuration-settings.rst b/source/administration-guide/configure/push-notification-server-configuration-settings.rst index 1769807d1ec..e20858adee3 100644 --- a/source/administration-guide/configure/push-notification-server-configuration-settings.rst +++ b/source/administration-guide/configure/push-notification-server-configuration-settings.rst @@ -95,19 +95,26 @@ See our :ref:`configuration settings Push Notification Server :configjson: .EmailSettings.PushNotificationServer :environment: MM_EMAILSETTINGS_PUSHNOTIFICATIONSERVER - :description: The physical location of the Mattermost Hosted Notification Service (HPNS) server. + :description: The region of the Mattermost Hosted Push Notification Service (HPNS) server. Push notification server location ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -+-----------------------------------------------------------------+--------------------------------------------------------------------------------+ -| The physical location of the Mattermost Hosted Push | - System Config path: **Environment > Push Notification Server** | -| Notification Service (HPNS) server. | - ``config.json`` setting: ``EmailSettings`` > ``PushNotificationServer`` | -| | - Environment variable: ``MM_EMAILSETTINGS_PUSHNOTIFICATIONSERVER`` | -| Select from **US** **(Default)** or **Germany** to | | -| automatically populate the **Push Notification Server** | | -| field server URL. | | -+-----------------------------------------------------------------+--------------------------------------------------------------------------------+ ++-------------------------------------------------------+---------------------------------------------------------------------------+ +| The region of the Mattermost Hosted Push Notification | - System Config path: **Environment > Push Notification Server** | +| Service (HPNS) server. | - ``config.json`` setting: ``EmailSettings`` > ``PushNotificationServer`` | +| | - Environment variable: ``MM_EMAILSETTINGS_PUSHNOTIFICATIONSERVER`` | +| Select a region to automatically populate the | | +| **Push Notification Server** field with the | | +| corresponding URL: | | +| | | +| - **Global**: ``https://global.push.mattermost.com`` | | +| (load balances requests across the regional | | +| endpoints below) | | +| - **US**: ``https://us.push.mattermost.com`` | | +| - **EU**: ``https://eu.push.mattermost.com`` | | +| - **Japan**: ``https://ap.push.mattermost.com`` | | ++-------------------------------------------------------+---------------------------------------------------------------------------+ .. config:setting:: maximum-notifications-per-channel :displayname: Maximum notifications per channel (Push Notifications) diff --git a/source/deployment-guide/mobile/mobile-troubleshooting.rst b/source/deployment-guide/mobile/mobile-troubleshooting.rst index ae79aadf1e9..2c38e1756c9 100644 --- a/source/deployment-guide/mobile/mobile-troubleshooting.rst +++ b/source/deployment-guide/mobile/mobile-troubleshooting.rst @@ -51,13 +51,13 @@ All my outbound connections need to go through a proxy. How can I connect to the You can set up an internal server to proxy the connection out of their network to the Mattermost Hosted Push Notification Service (HPNS) by following the steps below: 1. Make sure your proxy server is properly configured to support SSL. Confirm it works by checking the URL at https://www.digicert.com/help/. -2. Setup a proxy to forward requests to ``https://push.mattermost.com``. +2. Setup a proxy to forward requests to the HPNS URL matching your server's :ref:`push notification server location `: ``https://global.push.mattermost.com``, ``https://us.push.mattermost.com``, ``https://eu.push.mattermost.com``, or ``https://ap.push.mattermost.com``. 3. In Mattermost set **System Console** > **Notification Settings** > **Mobile Push** > **Enable Push Notifications** in prior versions or **System Console > Environment > Push Notification Server > Enable Push Notifications** in versions after 5.12 to "Manually enter Push Notification Service location" 4. Enter the URL of your proxy in the **Push Notification Server** field. -.. Note:: +.. Note:: - Depending on how your proxy is configured you may need to add a port number and create a URL like ``https://push.internalproxy.com:8000`` mapped to ``https://push.mattermost.com`` + Depending on how your proxy is configured you may need to add a port number and create a URL like ``https://push.internalproxy.com:8000`` mapped to your region's HPNS URL, such as ``https://us.push.mattermost.com``. Build gets stuck at ``bundleReleaseJsAndAssets`` ------------------------------------------------ diff --git a/source/end-user-guide/preferences/troubleshoot-notifications.rst b/source/end-user-guide/preferences/troubleshoot-notifications.rst index 6048a56a3d8..594791177e9 100644 --- a/source/end-user-guide/preferences/troubleshoot-notifications.rst +++ b/source/end-user-guide/preferences/troubleshoot-notifications.rst @@ -209,7 +209,7 @@ Yes, push notifications are free if you compile your own `push-proxy service `_, offers transport-level encryption, but not production-level service level agreements (SLAs). -If you need production-level SLAs for push notifications, you can either compile your own push-proxy service, with your own key, or you can use a paid option and become a Mattermost Professional subscriber `agreeing to our Conditions of Use `_, which enables you to use a production-level Hosted Push Notification Service (HPNS) at ``https://push.mattermost.com``. +If you need production-level SLAs for push notifications, you can either compile your own push-proxy service, with your own key, or you can use a paid option and become a Mattermost Professional subscriber `agreeing to our Conditions of Use `_, which enables you to use a production-level Hosted Push Notification Service (HPNS) at a regional URL such as ``https://global.push.mattermost.com`` — see the :ref:`push notification server location ` setting for the full list of regions. Learn more about :ref:`our push notification service `. From d14edfebddbeeb603ce4f66d25a052e51f8eedd7 Mon Sep 17 00:00:00 2001 From: Marco Date: Tue, 28 Jul 2026 12:31:16 +0200 Subject: [PATCH 2/2] Clarify EU/AP region labels and note deprecated legacy HPNS URLs Labels the EU and AP regions with their legacy names (Germany, Japan) and documents that push.mattermost.com and hpns-de.mattermost.com are deprecated aliases now pointing to the new regional infrastructure. Co-Authored-By: Claude Sonnet 5 --- ...fication-server-configuration-settings.rst | 33 ++++++++++--------- 1 file changed, 18 insertions(+), 15 deletions(-) diff --git a/source/administration-guide/configure/push-notification-server-configuration-settings.rst b/source/administration-guide/configure/push-notification-server-configuration-settings.rst index e20858adee3..a128c3fa6a0 100644 --- a/source/administration-guide/configure/push-notification-server-configuration-settings.rst +++ b/source/administration-guide/configure/push-notification-server-configuration-settings.rst @@ -100,21 +100,24 @@ See our :ref:`configuration settings Push Notification Server** | -| Service (HPNS) server. | - ``config.json`` setting: ``EmailSettings`` > ``PushNotificationServer`` | -| | - Environment variable: ``MM_EMAILSETTINGS_PUSHNOTIFICATIONSERVER`` | -| Select a region to automatically populate the | | -| **Push Notification Server** field with the | | -| corresponding URL: | | -| | | -| - **Global**: ``https://global.push.mattermost.com`` | | -| (load balances requests across the regional | | -| endpoints below) | | -| - **US**: ``https://us.push.mattermost.com`` | | -| - **EU**: ``https://eu.push.mattermost.com`` | | -| - **Japan**: ``https://ap.push.mattermost.com`` | | -+-------------------------------------------------------+---------------------------------------------------------------------------+ ++--------------------------------------------------------+---------------------------------------------------------------------------+ +| The region of the Mattermost Hosted Push Notification | - System Config path: **Environment > Push Notification Server** | +| Service (HPNS) server. | - ``config.json`` setting: ``EmailSettings`` > ``PushNotificationServer`` | +| | - Environment variable: ``MM_EMAILSETTINGS_PUSHNOTIFICATIONSERVER`` | +| Select a region to automatically populate the | | +| **Push Notification Server** field with the | | +| corresponding URL: | | +| | | +| - **Global**: ``https://global.push.mattermost.com`` | | +| (load balances requests across the regional | | +| endpoints below) | | +| - **US**: ``https://us.push.mattermost.com`` | | +| - **EU (Germany)**: ``https://eu.push.mattermost.com`` | | +| - **AP (Japan)**: ``https://ap.push.mattermost.com`` | | ++--------------------------------------------------------+---------------------------------------------------------------------------+ + +.. note:: + ``https://us.push.mattermost.com`` supersedes the legacy ``https://push.mattermost.com`` URL, and ``https://eu.push.mattermost.com`` supersedes the legacy ``https://hpns-de.mattermost.com`` URL. The legacy URLs still work, but are deprecated and now point to the same new infrastructure as their replacements above. .. config:setting:: maximum-notifications-per-channel :displayname: Maximum notifications per channel (Push Notifications)