---
title: "Rocket Chat Desktop App Guide"
slug: "desktop-app"
description: "Learn to set up and customise the Rocket Chat desktop app. Build secure collaboration tools for enterprise communication."
updated: 2026-02-25T12:14:34Z
published: 2026-02-25T15:55:33Z
canonical: "developer.rocket.chat/desktop-app"
---

> ## 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.

# Desktop App Setup

The Rocket.Chat Desktop App is a cross-platform client built with [Electron](https://www.electronjs.org/), 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](http://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
- [Node.js](https://nodejs.org) v24.11.1 or higher
- [node-gyp](https://github.com/nodejs/node-gyp#installation)
- [Yarn](http://yarnpkg.com/) v4.6.0
- An active Rocket.Chat workspace. You can set up a [local development server environment](/v1/docs/server-environment-setup) or [deploy a new workspace](https://docs.rocket.chat/docs/deploy-rocketchat).

> [!WARNING]
> 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](https://github.com/RocketChat/Rocket.Chat.Electron):

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

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

```bash
cd Rocket.Chat.Electron
yarn
```
2. Launch the desktop app and start watching for changes as you keep building:

```bash
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](/v1/docs/developing-your-desktop-app)
- [White-label Your Desktop App](/v1/docs/desktop-app-white-labeling)
- [Debugging your Desktop App](/v1/docs/debugging-your-desktop-app)

> [!NOTE]
> Additional resources
> 
> To install the desktop app on your device, refer to these guides:
> 
> - [Minimum Requirements for Client Apps](https://docs.rocket.chat/v1/docs/minimum-requirements-for-client-apps)
> - [Install Desktop & Mobile App](https://docs.rocket.chat/docs/desktop-mobile-apps)