Install Desktop & Mobile App

Prev Next

Rocket.Chat does not support for connections from cloud services and official mobile/desktop apps to workspaces running legacy versions outside our support window. Users on unsupported legacy servers are advised to upgrade to the latest Rocket.Chat version to ensure continued access to cloud, mobile, and desktop applications. Each Rocket.Chat version is supported for six months post-release.

This guide provides instructions for installing and updating the Rocket.Chat client applications on desktop and mobile devices. Whether you're using Windows, macOS, Linux, iOS, or Android, follow the instructions below to set up the app on your preferred platform and start accessing your workspace. Before you install, check the minimum requirements for client apps to access Rocket.Chat.

For desktop communication, Rocket.Chat offers robust applications that seamlessly integrate with your Windows, MacOS, or Linux environment.

  1. Windows: Download from the Windows Store.

  2. macOS: Install from the Mac App Store.

  3. Linux (Ubuntu):  Install our Snap using the command below: 

    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.

To download the desktop app’s source files for manual installation, visit the Desktop app releases repository and download your preferred release file from the Assets section.

Visit the Silent installation for desktop apps guide to install Rocket.Chat desktop app silently on different operating systems.

To ensure that you stay connected, no matter where you are, Rocket.Chat offers dedicated applications for iOS and Android devices.

Beta versions

Beta versions of our apps are available on Google Play beta and TestFlight. Help us test new features!

Experimental versions

Our experimental mobile apps are built using identical technologies and codebases as the official version. These apps serve as a platform for us to test new features and gather user feedback. Only the features that prove stable are incorporated into the official version.

Android

Apple

Play Store

iOS version isn't available on App Store anymore.

After installation, see Access Your Workspace to continue with the next steps.

Update desktop & mobile apps

Automatic updates

  1. If you installed the Rocket.Chat desktop app from the Mac App Store or the Windows Store, updates are applied automatically by your operating system.

  2. If you downloaded the app from the Desktop app releases repository using a .exe file for Windows, .dmg or .zip for macOS, or .AppImage for Linux, the app includes a built-in updater. When a new version is available, you'll see an in-app prompt with the option to:

    • Install the update immediately

    • Be reminded later

    • Skip the update

  3. If you installed the app using Snap, updates are applied automatically by the Snap system.

Manual updates

If you installed the app using a .deb, .rpm, or .tar.gz package, you need to update it manually using your system's package manager or by downloading the latest version from GitHub releases.

To update the Rocket.Chat mobile app, go to the App Store (iOS) or Play Store (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, RPM, AppImage, Snap, Flatpak

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:

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 (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 :

    rocketchat-<version>-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.

rocketchat-4.12.0-win.exe /S /allusers

/currentuser

Install for only the current user. This is the default silent install behaviour.

rocketchat-4.12.0-win.exe /S /currentuser

/disableAutoUpdates

Disable automatic updates for the desktop app after the installation.

rocketchat-4.12.0-win.exe /S /disableAutoUpdates

/D=<path>

Install to a custom directory. The /D=<path> parameter must be the last parameter on the command line and must not contain quotes, even if the path contains spaces.

rocketchat-4.12.0-win.exe /S /D=C:\Apps\RocketChat

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 (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 :

    msiexec /i rocketchat-<version>-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:

msiexec /x rocketchat-<version>-win-x64.msi /quiet

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 (for example, rocketchat-4.12.0-mac.pkg).

  2. Go to your terminal and run this command:

    sudo installer -pkg <path-to-pkg> -target <volume>

    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.

    For example, to install the desktop app to the main disk:

    sudo installer -pkg rocketchat-4.12.0-mac.pkg -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.

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

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.

sudo installer -pkg rocketchat-4.12.0-mac.pkg -target / -allowUntrusted

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 (for example, rocketchat-4.12.0-linux-amd64.deb).

  1. For basic installation, run:

    sudo dpkg -i rocketchat-<version>-linux-amd64.deb

  2. To install using apt, run:

    sudo apt install ./rocketchat-<version>-linux-amd64.deb -y

  3. For non-interactive installation:

    export DEBIAN_FRONTEND=noninteractive
sudo apt install ./rocketchat-4.11.1-linux-amd64.deb -y

  4. For silent uninstallation:

    sudo apt remove rocketchat-desktop -y
sudo apt purge rocketchat-desktop -y # To also remove configuration