Rocket.Chat in CentOS


Depending on the version of Rocket.Chat you want to install, check the release notes to see the supported engine versions for MongoDB and NodeJs, and install as recommended.

Install Rocket.Chat

  • Install the required dependency packages.
sudo yum install -y GraphicsMagick
curl -L -o /tmp/
  • Extract the Rocket.Chat server files.
tar -xzf /tmp/ -C /tmp
cd /tmp/bundle/programs/server && npm install
  • Move the extracted files to the /opt directory.
sudo mv /tmp/bundle /opt/Rocket.Chat
This guide uses the /opt directory. However, you can choose your preferred directory.

Configure the Rocket.Chat service

  • Add the Rocket.Chat user and set the proper permissions on the Rocket.Chat folder.
sudo useradd -M rocketchat && sudo usermod -L rocketchat
sudo chown -R rocketchat:rocketchat /opt/Rocket.Chat
  • Create the Rocket.Chat service file.
cat << EOF |sudo tee -a /lib/systemd/system/rocketchat.service
Description=The Rocket.Chat server nginx.service mongod.service
ExecStart=/usr/local/bin/node /opt/Rocket.Chat/main.js
Environment=MONGO_URL=mongodb://localhost:27017/rocketchat?replicaSet=rs01 MONGO_OPLOG_URL=mongodb://localhost:27017/local?replicaSet=rs01 ROOT_URL=http://localhost:3000/ PORT=3000
  • Using sudo and your preferred text editor, open the Rocket.Chat service file just created (/usr/lib/systemd/system/rocketchat.service). Change the ROOT_URL environmental variable to reflect the URL you want to access the server with. Optionally, you can change the MONGO_URL, MONGO_OPLOG_URL and PORT variables.
  • Set up the storage engine and replication for MongoDB.
sudo sed -i "s/^# engine:/ engine: mmapv1/" /etc/mongod.conf
sudo sed -i "s/^#replication:/replication:\n replSetName: rs01/" /etc/mongod.conf
The MongoDB replica set is mandatory for Rocket.Chat > 1.0.0.
  • Enable and start MongoDB.
sudo systemctl enable mongod && sudo systemctl start mongod
mongo --eval "printjson(rs.initiate())"
  • Enable and start Rocket.Chat
sudo systemctl enable rocketchat && sudo systemctl start rocketchat

Configure your Rocket.Chat server

Open a web browser, and go to the configured ROOT URL ( Follow the configuration prompts to set up an admin account, your server info, and your organization info.


502 Bad Gateway

When installing Rocket.Chat on CentOS or RHEL, you may encounter a 502 Bad Gateway error after setting up a reverse proxy with Nginx. To fix this, enable loopback for your upstream in SELinux.
setsebool -P httpd_can_network_connect 1

ZLIB version problem

Some users had experienced problems starting Rocket.Chat server in CentOS because their zlib version is not compatible with Rocket.Chat.
If you find an error message similar to the following in the logs:
Exception in callback of async function: Error: /lib64/ version `ZLIB_1.2.9' not found
Add this environmental variable to the Rocket.Chat service file (/usr/lib/systemd/system/rocketchat.service):