--- title: "Install Desktop and Mobile App" slug: "desktop-mobile-apps" description: "Download Rocket Chat desktop and mobile apps for secure messaging. Stay connected with open source collaboration tools across devices, anywhere you work." status: "update" updated: 2026-11-12T18:36:07Z published: 2026-11-12T18:36:07Z canonical: "docs.rocket.chat/desktop-mobile-apps" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.rocket.chat/llms.txt > Use this file to discover all available pages before exploring further. # Install Desktop and Mobile App This guide explains how to install, update, and manage Rocket.Chat client applications across desktop and mobile devices. It is intended for both individual users and IT administrators deploying at scale. Rocket.Chat provides native applications for: - **Desktop**: Windows, macOS, Linux - **Mobile**: iOS, Android Before installation, review the [Minimum Requirements for Client Apps](/v1/docs/minimum-requirements-for-client-apps) to confirm your device is supported. Select the **desktop app** or **mobile app** tab to view installation instructions for your device: Desktop appMobile app For desktop communication, Rocket.Chat offers robust applications that seamlessly integrate with your Windows, MacOS, or Linux environment. #### Standard installation 1. **Windows**: Download from the [Windows Store](https://apps.microsoft.com/detail/9NBLGGH52JV6?hl=en-us&gl=NG&ocid=pdpshare). 2. **macOS**: Install from the [Mac App Store](https://apps.apple.com/app/rocket-chat/id1086818840). 3. **Linux** (Ubuntu): Install our [Snap](https://snapcraft.io/rocketchat-desktop) using the command below: ```bash sudo snap install rocketchat-desktop ``` The advantage of Snaps is that they automatically update, eliminating the need for manual client updates. They are also compatible with other [platforms](https://snapcraft.io/docs/installing-snapd). #### Manual installation If you prefer manual setup with an installer file: 1. Go to the [Rocket.Chat desktop releases repository](https://github.com/RocketChat/Rocket.Chat.Electron/releases). 2. Locate the version of Rocket.Chat you want to install. 3. Download the appropriate file for your system from the **Assets** section: 1. Windows: `.exe` or `.msi` 2. macOS: `.dmg` or `.zip` 3. Linux: `.AppImage`, `.deb`, or `.rpm` 4. Run the installer. To deploy the app silently across multiple machines, refer to the [Silent Installation for Desktop Apps](/v1/docs/desktop-mobile-apps#silent-installation-for-desktop-app) section below. Rocket.Chat offers dedicated mobile apps for iOS and Android, keeping you connected wherever you are. ### Official versions | Android | Apple | | --- | --- | | [Play Store](https://play.google.com/store/apps/details?id=chat.rocket.android&pli=1) | [App Store](https://apps.apple.com/us/app/rocket-chat/id1148741252) | ### Beta versions Beta versions of our apps are available on Google Play beta and TestFlight. Help us test new features! | Android | Apple | | --- | --- | | [Play Store](https://play.google.com/apps/testing/chat.rocket.android) | [TestFlight](https://testflight.apple.com/join/3gcYeoMr) | > [!NOTE] > - See the [Minimum Requirements for Client Apps](/v1/docs/minimum-requirements-for-client-apps) document for the list of supported OS. > - See how to [Configure Push Notifications](/v1/docs/push) for mobile devices. After installation, see [Access Your Workspace](/v1/docs/access-your-workspace) to continue with the next steps. --- ## Update desktop & mobile apps Desktop appMobile app You can check for a newer version of the desktop app directly from the Application menu. When an update is detected, the app presents the appropriate workflow based on your installation source. To update your desktop app: 1. Open the **Application menu** by selecting the three-dot icon (located in the top bar or at the bottom of the left sidebar). 2. Select **Check for Updates**. 3. Review the status indicator in the top-right corner of the workspace header: 1. **Up to date**: A green “*You’re up to date”* button confirms your client is current. 2. **New release available**: A blue “*Update”* button appears. Click it to open the release details. 4. Review your active build against the incoming version, then choose your action: Select **Skip this version** to dismiss the release. 1. **Store installs**: Click **Open App Store** to be redirected to your platform's native store page to complete the download and installation. 2. **Direct installs**: Click **Install** update to begin downloading the package. 5. For direct installs, click **Restart to update** after the download finishes to apply the release and relaunch the application. After updating successfully, the blue button changes to green, confirming you’re up to date. To update the Rocket.Chat mobile app, go to the [App Store](https://apps.apple.com/us/app/rocket-chat/id1148741252) (iOS) or [Play Store](https://play.google.com/store/apps/details?id=chat.rocket.android&pli=1) (Android). Each platform handles updates differently, so you can check your device settings if the app hasn't updated automatically. --- ## Silent installation for desktop app For large-scale enterprises, you can install Rocket.Chat desktop app silently in the background without displaying any windows, progress bars, or pop-up prompts. Before proceeding, confirm that your target environment meets the minimum requirements below: | Platform | Installer types | Minimum OS version | Architecture | Required disk space | | --- | --- | --- | --- | --- | | Windows | NSIS (.exe), MSI (.msi) | Windows 10 or later | x64, ia32, arm64 | ~200 MB | | macOS | PKG (.pkg) | macOS 12 (Monterey) or later | Universal (x64 and Apple silicon) | ~250 MB | | Linux | DEB | Ubuntu 22.04 or equivalent | x64 | ~200 MB | With the requirements confirmed, you can proceed with the installation. Select the platform that matches your OS and follow the corresponding instruction: **Windows** Silent installation for Rocket.Chat desktop app on Windows can be done using the NSIS or MSI installer. #### NSIS installer (.exe) The NSIS installer is the recommended method for Windows installations. It supports full silent installation with various customizable options. To install Rocket.Chat desktop app using the NSIS installer: 1. Download the *.exe* installer file asset for your preferred release from the [Desktop app releases repository](https://github.com/RocketChat/Rocket.Chat.Electron/releases) (*for example, rocketchat-4.12.0-win.exe*). 2. Go to your CMD or Powershell and navigate to the directory that has the *.exe* file. 3. Use the `/S` command to install the desktop app silently for the current user : ```bash rocketchat--win.exe /S ``` For example, `rocketchat-4.12.0-win.exe /S`. 4. After it’s executed, Rocket.Chat desktop app is fully available on your system. To customize your installation, you can explore any of the following options: | Flag | Description | Example | | --- | --- | --- | | `/allusers` | Install for all users on the system. It requires administrator privileges. | ```bash rocketchat-4.12.0-win.exe /S /allusers ``` | | `/currentuser` | Install for only the current user. This is the default silent install behaviour. | ```bash rocketchat-4.12.0-win.exe /S /currentuser ``` | | `/disableAutoUpdates` | Disable automatic updates for the desktop app after the installation. | ```bash rocketchat-4.12.0-win.exe /S /disableAutoUpdates ``` | #### MSI installer (.msi) The MSI installer is ideal for enterprise deployments using Group Policy, SCCM, Intune, or other deployment tools. To install Rocket.Chat desktop app using the MSI installer: 1. Download the *.msi* installer file asset for your preferred release from the [Desktop app releases repository](https://github.com/RocketChat/Rocket.Chat.Electron/releases) (*for example, rocketchat-4.12.0-win-x64.msi*). 2. Go to your CMD or Powershell and navigate to the directory that has the *.msi* file. 3. Use the `/S` command to install the desktop app silently for the current user : ```bash msiexec /i rocketchat--win-x64.msi /quiet ``` For example, `msiexec /i rocketchat-4.12.0-win-x64.msi/quiet`. 4. After it’s executed, Rocket.Chat desktop app is fully available on your system. To uninstall the Rocket.Chat desktop app: ```bash msiexec /x rocketchat--win-x64.msi /quiet ``` **macOS** Silent installation for Rocket.Chat desktop app on macOS can be done using the PKG installer. #### PKG installer (.pkg) The PKG installer supports silent installation using the macOS installer command. To install Rocket.Chat desktop app using the PKG installer: 1. Download the *.pkg* installer file asset for your preferred release from the [Desktop app releases repository](https://github.com/RocketChat/Rocket.Chat.Electron/releases) (*for example, rocketchat-4.12.0-mac.pkg*). 2. Go to your terminal and run this command: ```bash sudo installer -pkg -target ``` For example, to install the desktop app to the main disk: ```bash sudo installer -pkg rocketchat-4.12.0-mac.pkg -target / ``` 1. `sudo`: Runs the command with administrator privileges 2. `-pkg <path-to-pkg>`: Specifies the pkg package you want to install 3. `-target <volume>`: Specifies the target destination for the installation. Use `/` to specify the main disk as the target. 3. After it’s executed, Rocket.Chat desktop app is fully available on your system. To customize your installation, you can explore any of the following options: | Flag | Description | Example | | --- | --- | --- | | `/-verboseR` | Get real-time feedback during the installation process as the package is executed. | ```bash sudo installer -pkg rocketchat-4.12.0-mac.pkg -target / -verboseR ``` | | `-dumplog` | Get logs from the installation proccess and save to a file. It’s useful for debggin | ```bash sudo installer -pkg rocketchat-4.12.0-mac.pkg -target / \ -dumplog 2>&1 \| tee /tmp/rocketchat-install.log ``` | | `/-allowUntrusted` | By default, macOS rejects any package that isn't signed by a recognized developer or has an expired security certificate. Use this flag to bypass those checks if you’re certain that the package is safe. | ```bash sudo installer -pkg rocketchat-4.12.0-mac.pkg -target / -allowUntrusted ``` | **Linux** #### Ubuntu/Debian (.deb) To install Rocket.Chat desktop app silently on Ubuntu or Debian devices: Download the *.deb* installer file asset for your preferred release from the [Desktop app releases repository](https://github.com/RocketChat/Rocket.Chat.Electron/releases) (*for example, rocketchat-4.12.0-linux-amd64.deb*). 1. For basic installation, run: ```plaintext sudo dpkg -i rocketchat--linux-amd64.deb ``` 2. To install using apt, run: ```bash sudo apt install ./rocketchat--linux-amd64.deb -y ``` 3. For non-interactive installation: ```bash export DEBIAN_FRONTEND=noninteractive sudo apt install ./rocketchat-4.11.1-linux-amd64.deb -y ``` 4. For silent uninstallation: ```bash sudo apt remove rocketchat-desktop -y sudo apt purge rocketchat-desktop -y # To also remove configuration ``` --- ## Override settings in Rocket.Chat desktop You can customize the Rocket.Chat desktop app's default behavior using a configuration override file. This is useful for enforcing organization-wide settings such as disabling automatic updates, hiding the tray icon, or restricting users to a single server. ### How to apply overrides 1. Choose where to save the file. The first location in each list is the user data folder, which applies the settings to one user. The second is the installation folder, which applies the settings to everyone who uses the app on that device. If both folders have the file, the settings in the installation folder take priority. **Windows** - `C:\Users\<username>\AppData\Roaming\Rocket.Chat\` - `C:\Program Files\Rocket.Chat\resources\` **MacOS** - `~/Library/Application Support/Rocket.Chat/` - `/Applications/Rocket.Chat.app/Contents/Resources/` **Linux** - `~/.config/Rocket.Chat/` - `/opt/Rocket.Chat/resources/` 1. In that folder, create a file named `overridden-settings.json`. 2. Add only the settings you want to override. For example, to prevent users from adding new workspaces: ```json {  "isAddNewServersEnabled": false } ``` You can also include multiple overrides in the file like this: ```json {  "isAddNewServersEnabled": false,  "isTrayIconEnabled": false,  "isMinimizeOnCloseEnabled": false } ``` Any setting defined in this file will take precedence over the app's defaults and any individual user preferences whenever the app is launched. ### Settings you can override | Setting | Description | | --- | --- | | `isReportEnabled` | Toggles whether bug reports are automatically sent to developers. | | `isInternalVideoChatWindowEnabled` | Open video calls in an internal window instead of a browser when enabled. | | `isUpdatingEnabled` | Determines if the user is permitted to update the application. | | `doCheckForUpdatesOnStartup` | When `true`, the app automatically checks for updates at launch. | | `isMenuBarEnabled` | Windows and Linux only. When `true`, the menu bar is always visible. When `false`, the menu bar is hidden until the user presses **Alt**. | | `isTrayIconEnabled` | Toggles the visibility of the tray icon. It overrides `isMinimizeOnCloseEnabled`. | | `isAddNewServersEnabled` | When `false`, the *Add Server* buttons and shortcuts are disabled. | | `isFlashFrameEnabled` | Enable flash frame notifications | | `isMinimizeOnCloseEnabled` | If `true`, clicking *close (X)* minimizes the app to the taskbar. | | `isNotificationQuickReplyEnabled` | Windows and macOS only. When `false`, notifications don't include the inline reply field. The default is `true`. | --- ## Preset workspaces in Rocket.Chat desktop You can add workspaces to the desktop app for your users with a `servers.json` file. When the app starts with no workspaces in the sidebar, it adds every workspace listed in the file. Users skip the **Connect to server** screen and go straight to the login screen of the first workspace. ### Create the servers.json file List each workspace as a name and URL pair. The name is the label users see in the sidebar. ```json {  "Acme Workspace": "https://chat.acme.com",  "Acme Partners": "https://partners.acme.com" } ``` ### Save the servers.json file Save the file in one of these folders: | Operating system | Installation folder (all users) | User data folder (one user) | | --- | --- | --- | | Windows | `C:\Program Files\Rocket.Chat\resources\` | `C:\Users\<username>\AppData\Roaming\Rocket.Chat\` | | macOS | `/Library/Preferences/Rocket.Chat/` or `/Applications/Rocket.Chat.app/Contents/Resources/` | `~/Library/Application Support/Rocket.Chat/` | | Linux | `/opt/Rocket.Chat/resources/` | `~/.config/Rocket.Chat/` | **Installation folder:** Bundle the file with the app when you deploy it. The app reads the file whenever the sidebar has no workspaces. On macOS, the app uses `/Library/Preferences/Rocket.Chat/servers.json` first if it exists. **User data folder:** Use this folder to add workspaces after the app is installed. The app reads the file once, adds the workspaces, and then deletes the file. The app reads `servers.json` only when the sidebar has no workspaces, for example, on first launch or after a user removes every workspace. Uninstalling the app doesn't remove the user's existing workspaces, so the file isn't read again after a reinstall unless the user data folder is also cleared. ### Lock users to specific workspaces To make sure users connect only to the workspaces you choose: 1. Add the workspaces to `servers.json` in the installation folder. 2. In `overridden-settings.json`, set `isAddNewServersEnabled` to `false`. See [Override settings in Rocket.Chat desktop](/docs/desktop-mobile-apps#override-settings-in-rocketchat-desktop). Users then see only the preset workspaces, and the options to add a workspace are turned off. After installing your desktop or mobile app, login to start using Rocket.Chat.