--- title: "iOS App White-Labeling" slug: "ios-app-white-labeling" description: "White-label Rocket Chat iOS apps. Customise branding and deliver secure communication for iOS users." updated: 2026-06-16T14:19:43Z published: 2026-06-16T14:19:43Z canonical: "developer.rocket.chat/ios-app-white-labeling" --- > ## 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. # iOS App White-Labeling ## General setup > [!WARNING] > As explained in the [requirements](/open-source-projects/mobile-app/mobile-app-white-labelling#requirements), the repo contains targets/build flavors to build our **experimental** and **official** apps. This guide covers the default flavor, which is the **Experimental app**. 1. Open [RocketChatRN.xcworkspace](https://github.com/RocketChat/Rocket.Chat.ReactNative/tree/single-server/ios/RocketChatRN.xcworkspace) on Xcode (15.x or 16.x). 2. On the General tab, select “**RocketChatRN**” and change **Display Name**, **Bundle Identifier**, **Version,** and **Build**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image.avif) 1. Select **ShareRocketChatRN** and **NotificationService** and change the same properties 1. `Display Name` and `Bundle Identifier` are different from the previous target. 2. `Version` and `Build` must be the same on all targets. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image 2(1).avif) 2. On Signing and Capabilities for **RocketChatRN**, check **Automatically manage signing**, select your app group, and add a keychain group. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/keychain RN.png) Similarly, on the **ShareRocketChatRN** and **NotificationService** targets, check **Automatically manage signing**, select your app group, and add the same keychain group. 3. Set the same app group on `RocketChatRN/Info.plist`, `ShareRocketChatRN/Info.plist` and `NotificationService/Info.plist` ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(14).png) ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(15).png) ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(16).png) 1. Set the same keychain group on `RocketChatRN/Info.plist`, `ShareRocketChatRN/Info.plist` and `NotificationService/Info.plist` ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(17).png) ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(19).png) ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(18).png) 1. It needs to be the same on all entitlements. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(20).png) ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(21).png) ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(22).png) 1. Change the app icon on `Experimental.xcassets/App Icon` ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(23).png) 1. Change the app splash screen on `Experimental.xcassets/Launch Screen Icon` ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(24).png) 2. Change the splash background colors on `Experimental.xcassets/splashBackgroundColor` ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(25).png) 3. Set your Bugsnag API key on `RocketChatRN/Info.plist` ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(26).png) ## Generate iOS app on Firebase 1. Visit the project overview on your [Firebase console](https://console.firebase.google.com). 2. Go to **Settings** > **Project settings**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(27).png) 3. On the “**General**” tab, click on “**iOS**” button under “**Your apps**” section: ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(28).png) 4. Enter your **bundle ID** and then “**Register app**”: ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(29).png) 5. Download the config file and move it as instructed: ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(30).png) 6. Add it to all targets: ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(31).png) ## Run the app Execute the following in the project terminal: ```bash yarn npx pod-install yarn ios ``` ## Configure the Apple developer portal ### Login to Apple developer portal 1. Visit your [Apple developer account](https://developer.apple.com/account). 2. Enter your credentials. 3. Click **Certificates, Identifiers & Profiles**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(32).png) ### Create an app identifier 1. Visit the [Apple identifier list](https://developer.apple.com/account/resources/identifiers/list). 2. Click to add **identifier**. 3. Select **App IDs** and click **Continue**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(33).png) 4. Add a **Description** and **Bundle ID**: ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(34).png) 5. On **Capabilities**, select **App Groups** and **Push notifications**. 6. Click **Continue** and then **Register**. ### Create an app identifier for the share extension version 1. Share extension is a version of the app that opens when you share data from another app to Rocket.Chat. For example, share a photo from the gallery. 2. Visit the [resources identifier list](https://developer.apple.com/account/resources/identifiers/list). 3. Click to add **Identifier**. 4. Select **App IDs** and **Continue**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(35).png) 5. Add a **description** and **Bundle ID**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(36).png) 6. This time, select only **App Groups** under **Capabilities**. 7. Click **Continue** and then **Register**. ### Create an app identifier for our notification service ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(37).png) ### Create an app group 1. Visit the [resources identifier list](https://developer.apple.com/account/resources/identifiers/list). 2. Click to add **Identifier**. 3. Select **App Groups** and **Continue**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(38).png) 4. Enter a **Description** and an **Identifier**: ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(39).png) 5. Click **Continue** and then **Register**. ### Apply app group 1. Visit the [resources identifier list](https://developer.apple.com/account/resources/identifiers/list). 2. Click on the first identifier you created. 3. On **App Groups**, click **Configure**. 4. Select the **App Group** you created and click **Continue**. 5. Click **Save**. 6. Repeat these steps for the second identifier you created for the Share Extension and notification service. ### Create push notifications certificates - Visit the [resources identifier list](https://developer.apple.com/account/resources/identifiers/list). - Click on the first identifier you created. - On **Push Notifications**, click **Configure**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(40).png) #### Development SSL Certificate 1. On **Development SSL Certificate**, click **Create Certificate**. 2. Follow the [official tutorial](https://help.apple.com/developer-account/#/devbfa00fef7) to generate a **Certificate Signing Request**. 3. Select the certificate you created and click **Continue**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(41).png) 4. Download the certificate and install it on your machine per the on-screen instructions. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(42).png) 5. After installing it, **Keychain Access** should have opened automatically on your Mac. 6. Export the certificate to generate a `.p12` file. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(43).png) 7. For simplicity, save it in the same folder of your CSR and `.cer`. You’ll need it later for SSL/TLS authentication and encryption. #### Production SSL Certificate 1. On **Production SSL Certificate**, click **Create Certificate**. 2. Follow the [official tutorial](https://help.apple.com/developer-account/#/devbfa00fef7) to generate a **Certificate Signing Request**. 3. Select the certificate you created and click **Continue**. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(44).png) 4. Download the certificate and install it on your machine per the on-screen instructions. ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(45).png) 5. After installing it, **Keychain Access** should have opened automatically on your Mac. 6. Export the certificate to generate a `.p12` file ![](https://cdn.us.document360.io/27ca1fd4-36d7-4cde-b4eb-97fc1652954c/Images/Documentation/image(46).png) 7. For simplicity, save it in the same folder as your CSR and `.cer`. You’ll need it later for SSL/TLS authentication and encryption. 8. Refer to the [Configuring Push Notifications](/v1/docs/configuring-push-notifications) document for further details on setting up push notifications.