---
title: "Mac OS Rocket.Chat Development Environment Setup"
slug: "macos-rocketchat-development-environment-setup"
description: "Configure Rocket Chat development on MacOS. Build, customise, and test secure communication solutions for enterprise needs."
updated: 2026-02-10T19:13:08Z
published: 2026-02-10T19:13:08Z
---

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

# Mac OS Rocket.Chat Development Environment Setup

This guide walks you through setting up a local Rocket.Chat development environment on macOS systems running on **Apple silicon** or **Intel processors.**

## Prerequisites

Install the following dependencies before you begin:

- [**Homebrew**](https://brew.sh/)**:**Package manager for macOS used to install required system dependencies.
- [**Yarn**](https://classic.yarnpkg.com/lang/en/docs/install/#mac-stable)**:** Package manager used to install project dependencies.

Verify that each dependency is installed:

```bash
brew --version
yarn --version
```

## Step 1: Clone the Rocket.Chat repository

1. Clone the official [Rocket.Chat repository](https://github.com/RocketChat/Rocket.Chat) to your local machine:

```bash
git clone https://github.com/<your-username>/Rocket.Chat.git
```

If you plan to contribute changes, fork the repository first and then clone your fork.
2. Navigate to the project directory and add the upstream repository to keep your fork synchronized with the original Rocket.Chat repository.

```bash
cd Rocket.Chat
git remote add upstream https://github.com/RocketChat/Rocket.Chat.git
```

## Step 2: Install Node.js

1. Install [Node Version Manager (nvm)](https://github.com/nvm-sh/nvm) to manage Node.js versions required for Rocket.Chat development.

```bash
brew install nvm
```

> [!WARNING]
> Verify that nvm version **0.39.2 or later** is installed by running the command `nvm --version` in your terminal.
2. Next, identify the Node.js version required by the project:

```bash
cd Rocket.Chat
cat package.json | grep -A4 engines | grep node
```
3. Install the required version (replace `x.x.x` with the version shown above):

```bash
nvm install x.x.x
```
4. Check the node version installed by running:

```bash
node -v
```

Ensure the output matches the required version.

## Step 3: Set up Deno

Rocket.Chat requires a specific version of Deno for certain development tools and scripts. Install the version defined in the project to ensure compatibility.

1. Confirm the [Deno](https://docs.deno.com) version required for your RocketChat project by running this command in the Rocket.Chat directory:

```bash
cat .tool-versions | grep deno
```
2. Install the required version of Deno (replace `x.x.x` with the version shown above):

```bash
curl -fsSL https://deno.land/install.sh | sh -s v1.37.1
```

> For alternative installation methods, see the official Deno [installation documentation](https://docs.deno.com/runtime/fundamentals/installation/).
3. Confirm you have the correct version installed by running:

```bash
deno --version
```

Ensure the installed version matches the project requirement and that Deno is available in your system PATH.

## Step 4: Install Meteor

Rocket.Chat requires a specific [Meteor](https://www.meteor.com/) version that matches your project release.

> [!WARNING]
> **Depending on the Rocket.Chat version, you may need to install a specific Meteor version.**
> 
> **Version guidance:**
> 
> - Rocket.Chat **6.x and earlier** → Meteor 2.x
> - Rocket.Chat **7.x and later** → Meteor 3.x
> 
> Always rely on the `.meteor/release` [file](https://github.com/RocketChat/Rocket.Chat/blob/develop/apps/meteor/.meteor/release) as the source of truth.

1. Check the `.meteor/release` file from the project root:

```bash
cat apps/meteor/.meteor/release
```
2. Install Meteor with the command below and replace `x.x` with the version identified above:

```bash
curl https://install.meteor.com/\?release\=x.x | sh
```
3. After installation, verify the version by running:

```bash
meteor --version
```

Ensure the installed version matches the project requirement.

## Step 5: Run the Rocket.Chat project

1. Install all the required dependencies and packages for your project by running this command in your Rocket.Chat directory:

```bash
yarn
```

> [!WARNING]
> Run this command from the project root, otherwise, [MongoDB will not start.](https://stackoverflow.com/questions/38988365/meteor-unexpected-mongo-exit-code-14-restarting-cant-start-mongo-server/39278452#39278452)
2. Build the application:

```bash
yarn build
```

> [!WARNING]
> You may see warnings about peer or transitive dependencies during the build. These are typically safe to ignore unless you are developing features that rely on them.
3. Start your development server.

For systems with 1**6 GB of memory or more**, use this command:

```bash
yarn dev
```

For systems with **less than 16 GB of memory**, use:

```bash
yarn dsv
```

> [!NOTE]
> The initial build may take 10 minutes or longer. Subsequent builds are usually faster.
4. After the build completes, open:

```arduino
http://localhost:3000
```

You should see your Rocket.Chat workspace running locally. If you encounter issues, see the [troubleshooting](/v1/docs/troubleshooting-development-environment-setup#macos-troubleshooting) guide.

## Step 6: Edit Rocket.Chat files

You can use any code editor, but [Visual Studio Code](https://code.visualstudio.com/download). is recommended for the best development experience.

- Open the cloned Rocket.Chat repository in your editor.
- As you make changes, the development server automatically rebuilds the application.
- If the server stops after a change, restart it with:

```bash
yarn dsv
```

You are now ready to contribute. See the [contribution guide](/v1/docs/modes-of-contribution) for next steps.