--- 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." updated: 2026-09-17T14:22:52Z published: 2026-09-17T14:22:52Z 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 10.15 (Catalina) or later | x64, arm64 (M1/M2) | ~250 MB | | Linux | DEB | Ubuntu 20.04 / RHEL 8 or later | x64, arm64 | ~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. Locate your user preference directory for Rocket.Chat similar to any of these below, depending on your operating system: **Windows** - *~\Users\\AppData\Roaming\Rocket.Chat\* - *~\Program Files\Rocket.Chat\Resources\* **MacOS** - *~/Users//Library/Application Support/Rocket.Chat/* - */Library/Preferences/Rocket.Chat/* **Linux** - */home//.config/Rocket.Chat/* - */opt/Rocket.Chat/resources/* 1. In that directory, create a new file named `overridden-settings.json` . 2. Add only the settings you want to override. For example, to create a single server mode and prevent the user from adding new servers: ```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` | Toggles the visibility of the top menu bar. | | `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. | After installing your desktop or mobile app, login to start using Rocket.Chat.