Deploying Rocket.Chat on Debian

If coming from Rocket.Chat 0.x.x to 0.40.0 please see our update notes

This guide explains how to deploy your own Rocket.Chat instance to a Debian Stretch Linux machine using the command line.

1. Install Dependencies

  • Node.js
  • MongoDB
  • curl
  • graphicsmagick
sudo apt-get install -y mongodb curl graphicsmagick

# We have to also install `npm`, which is the Node.js package manager. You can do this by typing:
sudo apt-get install npm

# If you encountered some errors when trying to install npm
# try to install nodejs in the first place.
# The nodejs package contains the nodejs binary as well as npm, so you don't need to install npm separately.
sudo apt-get install nodejs

# OR
# An alternative that can get you a more recent version of Node.js is to add a PPA maintained by NodeSource
curl -sL https://deb.nodesource.com/setup | sudo bash -
# After running the setup script from nodesource, you can install the Node.js package
# in the same way that you did above
sudo apt-get install nodejs
# In order for some npm packages to work (such as those that require building from source)
# you will need to install the build-essentials and python-dev packages:
sudo apt-get install build-essential python-dev
# for more please view the link below.

# Install a tool to let us change the node version.
sudo npm install -g n

# Rocket.Chat 0.60 and higher needs version 8.9.3 LTS of Node.js to work.
sudo n 8.9.3

More on nodejs installation

2. Install Rocket.Chat

From here you can follow the documentation for Ubuntu install, from step 2