Gitpod
If you are contributing to Rocket.Chat and will likely be working less than 50 hours a month on it, the quickest way to get started is via Gitpod.

Rocket.Chat Everywhere Development Environment on Gitpod

Gitpod runs a shared environment SaaS for developers working on open source projects. Please be respectful of other developers' needs and support Gitpod on their commercial side if you are able to.
Gitpod hosts the entire development environment and you will be able to contribute to Rocket.Chat wherever and whenever you have access to a browser; even from Internet Cafes and Chromebooks.

Steps for Gitpod Development

  • Start your workspace and link it to your GitHub account if necessary.
    A workspace will be created and loaded with a familiar Visual Studio Code environment
  • Next, start a terminal in your workspace and install meteor.
    Make sure you install the correct version of meteor. As of the time of this writing Rocket.Chat uses [email protected].
    To know which version you need, consult this file (tracking the current development branch, i.e. the most up to date).
  • Then run the following command passing in the release you want
1
curl https://install.meteor.com/?release=2.2 | sh
Copied!
You can also make this process simpler by running the following code snippet on your terminal.
1
curl https://install.meteor.com/?release=$(
2
curl -so- https://raw.githubusercontent.com/RocketChat/Rocket.Chat/develop/.meteor/release | cut [email protected] -f2
3
) | sh
Copied!
There will be warning messages, you do not need sudo (root access) on Gitpod.
  • Next, add the newly installed meteor to your path by running
1
export PATH=$PATH:/home/gitpod/.meteor
Copied!
  • Finally, install the node dependencies and start your server by running the following respectively.
1
meteor npm i
Copied!
  • Now set your ROOT_URL, without it Rocket.Chat server might misbahave.
1
export ROOT_URL=$(gp url 3000)
Copied!
  • Finally, start the Rocket.Chat server.
1
meteor npm start
Copied!
After a few minutes, your development environment should be up and running.
Once the server starts, you will see a popup window indicating that your server is running on port 3000. Click the Open Browser button to view and interact with your Rocket.Chat server instance.
You can modify the code in Visual Studio Code and see the changes immediately on the server instance thanks to hot code reload.
Start contributing to Rocket.Chat!
Last modified 18d ago