Why do I see the error ‘Server notifications are misconfigured!’?
This error appears when your server is not correctly configured to send push notifications. As a result, mobile push notifications may not be delivered.
In most cases, this can be resolved by verifying the following:
Rocket.Chat version: Ensure your server is running version 0.74.3 or later.
Rocket.Chat Cloud registration: Your server must be registered with Rocket.Chat Cloud to enable push notifications. To verify registration status, go to:
https://<your-server>/admin/cloud. If your server is not registered, complete the registration process on that page.
If the issue persists after confirming these steps, restart your server and re-test push notifications.
Why are my users not receiving push notifications?
If users are not receiving push notifications on mobile devices, verify the following configuration and conditions:
Push notifications are enabled: Go to Manage → Workspace → Settings → Push and confirm that push notifications are enabled.
Server connectivity: Ensure your server has outbound internet access and can reach:
https://gateway.rocket.chatPush notification quota: Community workspaces are limited to 10,000 push notifications per month. If the quota is exceeded, push notifications will not be delivered until the monthly limit resets.
User notification settings: Confirm that users:
Have not disabled notifications in their account preferences
Have not muted the specific room
Have allowed notifications at the mobile OS level (iOS/Android settings)
If all of the above are correctly configured and the issue persists, restart the server and re-test. You can also review server logs for push-related errors.
Why do notifications sometimes stop working in large channels?
Notifications may stop working if the number of members in a channel exceeds the configured notification limit.
You can adjust this setting under Manage → Workspace → Settings → General → Notifications
Can I hide message content in push notifications for compliance reasons (e.g., HIPAA)?
Yes. To hide message content in push notifications, go to Manage → Workspace → Settings → Push
Under the Privacy section, enable Hide message content from Apple and Google (and the Gateway, if enabled).
When enabled, only a message ID is sent in the push notification, and the mobile app securely fetches the message content. Note that this feature requires a Premium plan.
Do I need to restart Rocket.Chat after changing push settings?
Yes. Many push-related settings, such as Enable, Enable Gateway, Gateway URL, and Production, require a server restart before the changes take effect.
Why does the “Send a test push to my user” button not work?
If the test push is not received, verify the following:
You’re logged into the Rocket.Chat mobile app with the same account the test is being sent to.
The mobile app is minimized or closed. Push notifications are not displayed while the app is open and active.
Push notifications are enabled and properly configured under Manage → Workspace → Settings → Push.
Can I test push notifications for other users?
No. The “Send a test push to my user” button only works for the currently logged-in user. It cannot be used to send test push notifications on behalf of other users.
Can I use a custom push gateway instead of Rocket.Chat’s?
Yes. To use your own push gateway:
Disable the Enable Gateway toggle.
Provide your own certificates and keys in the Certificates and Keys section.
This setup is typically required for white-labeled mobile apps or enterprise deployments.
What happens when the monthly notification limit is reached?
Once the monthly quota is exhausted, Rocket.Chat stops sending push notifications.
Community workspaces are limited to 10,000 push notifications per month.
To continue receiving push notifications, upgrade to a Premium plan.