---
title: "Rocket Chat Push Notifications Setup"
slug: "configuring-push-notifications"
description: "Learn how to configure push notifications in Rocket Chat. Enable secure, real-time alerts for mobile collaboration."
updated: 2026-01-08T10:45:21Z
published: 2026-01-08T10:45:21Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developer.rocket.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuring Push Notifications

When you white-label the mobile app, the default push notification gateway is unavailable. To enable push notifications for your custom app build, follow this guide to configure them manually. This ensures that your workspace users on mobile devices continue to receive push notifications.

## Configuring gateway

- Navigate to **Manage**![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/Screenshot 2025-12-23 130522.png) **> Workspace > Settings** > **Push**on your workspace.
- Disable **Gateway**.
- Disable **Production**if you’re trying in debug mode.

## Configuring Android

#### Generating FCM service account

- Navigate to the **Cloud Messaging** tab on the Firebase project.
- Under **Firebase Cloud Messaging API**, tap on **Manage Service Accounts** to be redirected to Google Cloud Console.
- Go to **Create Service Account**, fill name and ID and click **Create and Continue**

![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/Create service account.avif)

- On **Grant this service account access to project**, filter for a role called **Firebase Cloud Messaging API Admin**

![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/Filter Cloud Messaging role.avif)

- Click **Done** and navigate to the Service Account you just created
- Go to **Keys > Add Key**

![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/Service account Keys.avif)

Service account > Keys

- Select **JSON** and click **Create**

![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/Generate service account JSON.png)

Generate service account JSON

- This JSON file is going to be used to send push notifications

#### Configuring FCM on Rocket.Chat

- Navigate to **Manage**![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/Screenshot 2025-12-23 130522.png) **> Workspace > Settings** > **Push**.
- Make sure **Use legacy notification provider** is turned off
- On **Certificates and Keys**, copy the**Service Account** content you just created to **Google FCM API Credentials**
- Save and restart your workspace.
- Log into the server as the same user on your mobile device and close it (it won’t receive push notification if it’s open).
- Navigate to **Manage**![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/Screenshot 2025-12-23 130522.png) **> Workspace > Settings** > **Push**and click on the **Send a test push to my user**button**.**

## Configuring iOS

- Ensure you have done "**Creating Push Notifications certificates**”.
- In your terminal, go to the folder which contains your push files (CSR, .cer, .p12).

#### Generating PEM files (Development)

To generate PEM files for a development environment,

- Run the following commands:

```bash
openssl x509 -in aps_development.cer -inform der -out DevPushCert.pem
openssl pkcs12 -nocerts -out DevPushKey.pem -in yourP12File.p12
```

- You **must** set a password for your PEM file.

#### Generating PEM files (Production)

To generate PEM files for a production environment,

- Run the following commands::

```bash
openssl x509 -in aps.cer -inform der -out PushCert.pem
openssl pkcs12 -nocerts -out PushKey.pem -in yourP12File.p12
```

- You **must** set a password for your PEM file.

#### Copying PEM files to Rocket.Chat

- Copy the contents of your development PEM files and password into **APN Dev Key**, **APN Dev Cert**, and **APN Dev Passphrase** on your **Push > Certificates and Keys**workspace settings.
- Copy the corresponding contents of your production PEM files and password into **APN Key, APN Cert,**and**APN Passphrase**on your **Push > Certificates and Keys** workspace settings.
- Get the content of your PEM files using `cat` by running this command:

```bash
cat PushKey.pem
```

- Save and restart your workspace.
- Log in to the server as the same user on your mobile device and close it (it won’t receive push notifications if it’s open).
- Navigate to **Manage**![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/Screenshot 2025-12-23 130522.png) **> Workspace > Settings** > **Push**and click on the **Send a test push to my user**button.

## Notification workflow

[Embedded content](https://cdn.iframe.ly/nC6ZW7n)

Page embed from Whimsical: [Notification workflow](https://whimsical.com/notification-workflow-PRwN4MWNsxSwqHjHXaPUuC)

> You can find more information on push notifications configuration in our [admin guide](https://docs.rocket.chat/use-rocket.chat/rocket.chat-mobile/push-notifications).