Mac OSX

You can set up and configure a Rocket.Chat development environment on your macOS system, whether it’s running on Apple Silicon or non-Apple Silicon chips.

Prerequisites

Install the following:

• Yarn

• Meteor version 2.x

• Homebrew

• Also, install Node Version Manager (nvm) with this command:

brew install nvm

Confirm that your nvm version is 0.39.2 or higher by running the command nvm --version in your terminal.

Setting up Meteor

Rocket.Chat currently supports Meteor 2.x. Therefore, using the newly released Meteor 3.x may cause errors. If you have Meteor 3.x or any unsupported version installed, follow these steps to uninstall it:

1. Remove the Meteor executable:

   sudo rm /usr/local/bin/meteor

2. Delete the Meteor installation directory:

   rm -rf ~/.meteor

Next, install the supported 2.x version of Meteor by running:

npx [email protected]

Ensure your computer is running Node.js 14

After installation, verify the version by running:

meteor --version

You should see the installed version displayed in your terminal.

Set up a Rocket.Chat development environment on MacOS Apple Silicon chip

1. Fork the Rocket.Chat repository on GitHub. Clone the forked repository to your local dev box using this command:

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

2. Navigate into the project directory and configure a remote to connect your local copy and the original Rocket.Chat repository. This allows you to easily pull updates and bug fixes from the main project without needing to clone it again.

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

3. Confirm the Node.js version required by your RocketChat version by executing the following command:

   cat package.json | grep -A4 engines | grep node

4. Install the required version of NodeJS replacing x.x.x with the required NodeJs version number:

   nvm install x.x.x

5. Initialize the meteor framework. This will show the version of meteor requested by Rocket.Chat (located in apps/meteor/.meteor/release). It will also initialize the framework.

   cd apps/meteor
   meteor --version
   cd ../..

6. Install all needed packages and proceed to build the Rocket.Chat app with these commands:

   yarn
   yarn build

7. Start your development server.

   For systems with 16 GB of memory or higher, use this command:

   yarn dev

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

   yarn dsv

   Once it is finished, check your terminal for a message confirming the successful deployment. The local server will now be running on http://localhost:3000.

If you encounter any issues, see troubleshooting.

Set up a Rocket.Chat development environment on Non-Apple Silicon chips

This setup instruction has been tested on MacBook Pro 2015, 8Gig Ram, 512Gb SSD,i5.

1. Meteor comes pre-installed with npm and node. Confirm the versions by executing this command:

   meteor node -v
   meteor npm -v

2. Install Yarn if it's not already on your system. It is the recommended package manager.

   npm install --global yarn

Information on the various versions of packages needed can be found in the package.json

4. To easily manage the node versions on your machine, install the n node package manager and switch to your desired NodeJs version.

   npm install -g n
   n x.x.x
   node -v

Replace x.x.x with the NodeJs version number.

5. Fork the Rocket.Chat repository on GitHub. Clone the forked repository and navigate to the project directory using this command:

   git clone https://github.com/your-username/Rocket.Chat
   cd Rocket.Chat

6. Run the following commands to navigate to the meteor directory and download the necessary meteor version for Rocket.Chat, as configured in .meteor/release file:

   cd apps/meteor
   meteor --version

7. Navigate to the project root directory and install all the needed packages by executing this command:

   cd ../..
   yarn

8. Build and startup your development server by running this command:

   yarn build
   yarn dev

   Once it is finished, check your terminal for a message confirming the successful deployment. The local server will now be running on http://localhost:3000.

Modify the code in your IDE to see the changes on the server instance. You can now start contributing to Rocket.Chat. Check out the contribution guide to learn more about the contribution process.

Troubleshooting

sudo chown -R $(whoami) ~/.yarn
sudo chmod -R u+w ~/.yarn

➤ YN0007: │ fibers@npm:5.0.3 must be built because it never has been before or the last one failed
➤ YN0009: │ fibers@npm:5.0.3 couldn't be built successfully (exit code 1, logs can be found here: /private/var/folders/…/build.log)
➤ YN0009: │ fibers@npm:5.0.3 couldn't be built successfully (exit code 1, logs can be found here: /private/var/folders/…/build.log)
➤ YN0009: │ fibers@npm:5.0.3 couldn't be built successfully (exit code 1, logs can be found here: /private/var/folders/…/build.log)

(mach-o file, but is an incompatible architecture (have 'x86_64', need 'arm64e')), '/usr/local/lib/bcrypt_lib.node' (no such file), '/usr/lib/bcrypt_lib.node' (no such file)