Desktop App Setup

The Rocket.Chat Desktop App is a cross-platform client built with Electron, enabling a single codebase to run on macOS, Windows, and Linux using web technologies. This guide walks through building the Rocket.Chat desktop application from source, including environment setup, dependency installation, and running the app locally for development. It assumes familiarity with TypeScript tooling and desktop application workflows.

Prerequisites

Before you begin, verify you have the following available on your machine:

• Git

• Node.js v24.11.1 or higher

• node-gyp

• Yarn v4.6.0

• An active Rocket.Chat workspace. You can set up a local development server environment or deploy a new workspace.

An active internet connection is required throughout the setup process to install dependencies and fetch packages.

Set up Rocket.Chat desktop app environment

1. From your preferred directory, clone the Rocket.Chat Electron repository:

   git clone https://github.com/RocketChat/Rocket.Chat.Electron.git

2. Navigate to the cloned directory and install the dependencies:

   cd Rocket.Chat.Electron
   yarn

3. Launch the desktop app and start watching for changes as you keep building:

   yarn start

If the build completes successfully, the Rocket.Chat desktop application will launch automatically. On first launch, you’ll be prompted to enter your workspace URL to connect the desktop client to your Rocket.Chat workspace.

Next steps

Once the environment is set up and the application is running, you can begin developing and customizing the desktop client to suit your requirements. This may include modifying UI components, adjusting native integrations, or extending application behavior.

• Develop your Desktop App

• White-label Your Desktop App

• Debugging your Desktop App

Additional resources

To install the desktop app on your device, refer to these guides:

• Minimum Requirements for Client Apps

• Install Desktop & Mobile App