Install Rocket.Chat Server with Nginx on Ubuntu 16.04

Step 1 - Install the Rocket.Chat Dependencies

Log in to the server using ssh (or the terminal) and type 'sudo su' to gain root access:

ssh vagrant@192.168.1.110
sudo su

Update the Ubuntu repository:

apt-get update

Next, install new packages needed by Rocket.Chat:

apt-get install curl graphicsmagick build-essential

Step 2 - Install MongoDB

Rocket.Chat requires MongoDB for the installation. In this step, we will install MongoDB 3.2 from the MongoDB repository.

Add the MongoDB keyserver so we can access the packages:

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv EA312927

Then add the MongoDB repository with the command below:

echo "deb http://repo.mongodb.org/apt/ubuntu "$(lsb_release -sc)"/mongodb-org/3.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.2.list

Update the repository and install MongoDB with the apt command:

apt-get update
apt-get install mongodb-org

Add MongoDB to run at the boot time and start it:

systemctl enable mongod
systemctl start mongod

MongoDB has been started on port 27017.

Step 3 - Configure MongoDB ReplicaSet

To improve the performance, Rocket.Chat uses a MongoDB ReplicaSet. In this step, we will configure a simple MongoDB ReplicaSet by editing the MongoDB configuration file.

Edit mongod.conf file with vim:

vim /etc/mongod.conf

Add a "#" at the beginning of line 24 to disable MongoDB running on the localhost IP only.

net:
    port: 27017
    #bindIp: 127.0.0.1

Add the ReplicaSet configuration below at line 34.

#replication:                                                          
replication:                                                           
   oplogSizeMB: 1                                                      
   replSetName: rs0

Save and exit.

Restart the MongoDB service:

systemctl restart mongod

Next, start the MongoDB shell and initiate the ReplicaSet:

export LC_ALL=C
mongo
rs.initiate()

Initiate results:

{
  "info2" : "no configuration specified. Using a default configuration for the set",
  "me" : "serverku-sensei:27017",
  "ok" : 1
}

Make sure the 'ok' value is 1. If the result is another number, then this means that something is wrong.

Step 4 - Install npm and nodejs

In this step, we will install nodejs and npm from the Ubuntu repository. Then we will install the n package with the npm command to get a specific nodejs version. Latest Rocket.Chat version needs nodejs 4.5.

Install nodejs and npm from the Ubuntu repository:

apt-get install nodejs npm

Next install the n package globally to the system with the npm command:

npm install -g n

Use the n command to download and set nodejs version 4.5.

sudo n 4.5

Finally, check the nodejs version:

node --version
npm -v

Step 5 - Install Rocket.Chat Server

We will install Rocket.Chat (latest version) in the /var/www/ directory.

Download the latest version of Rocket.Chat and extract it:

curl -L https://rocket.chat/releases/latest/download -o rocket.chat.tgz
tar -xzvf rocket.chat.tgz

Create a new /var/www/ directory and rename the bundle directory to 'Rocket.Chat' and then move it:

mkdir -p /var/www/
mv bundle Rocket.Chat
mv Rocket.Chat /var/www/

Go to the Rocket.Chat directory, set some required environment variables and start the Rocket.Chat server.

cd /var/www/Rocket.Chat/
cd programs/server/
npm install

cd ../../
export ROOT_URL=http://192.168.1.110:3000/
export MONGO_URL=mongodb://serverku:27017/rocketchat?replicaSet=rs0
export PORT=3000
node main.js

Rocket.Chat is installed, open your web browser and visit the server IP address on port 3000. 

Example : http://192.168.1.110:3000.

Step 6 - Install and Configure Nginx as Reverse Proxy for Rocket.Chat

In step 5, we installed Rocket.Chat as standalone application. In this tutorial, we will run Rocket.Chat behind the Nginx web server on https connections to get a secure and fast setup.

Install Nginx with the apt command:

apt-get install nginx

Create a new SSL directory:

mkdir -p /etc/nginx/ssl/
cd /etc/nginx/ssl/

Generate the SSL certificate file and change permission of the key file:

openssl req -new -x509 -days 365 -nodes -out /etc/nginx/ssl/rocket-chat.crt -keyout /etc/nginx/ssl/rocket-chat.key
chmod 400 rocket-chat.key

Next, create a new rocket-chat virtual host file in the sites-available directory.

cd /etc/nginx/sites-available/
vim rocket-chat

Paste the new virtual host configuration below:

# Upstreams
upstream backend {
    server 127.0.0.1:3000;
}
 
# Redirect Options
server {
  listen 80;
  server_name rocket-chat.co;
  # enforce https
  return 301 https://$server_name$request_uri;
}
 
# HTTPS Server
server {
    listen 443;
    server_name rocket-chat.co;
 
    error_log /var/log/nginx/rocketchat.access.log;
 
    ssl on;
    ssl_certificate /etc/nginx/ssl/rocket-chat.crt;
    ssl_certificate_key /etc/nginx/ssl/rocket-chat.key;
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2; # dont use SSLv3 ref: POODLE
 
    location / {
        proxy_pass http://192.168.1.110:3000/;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $http_host;
 
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forward-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forward-Proto http;
        proxy_set_header X-Nginx-Proxy true;
 
        proxy_redirect off;
    }
}

Save and exit.

I will run Rocket.Chat with new domain name 'rocket-chat.co'. Please use your own domain name and replace it in the configuration files wherever it appears.

Activate the Rocket.Chat virtual host and test the configuration file:

ln -s /etc/nginx/sites-available/rocket-chat /etc/nginx/sites-enabled/rocket-chat
nginx -t

Make sure there are no error messages.

Restart the Nginx web server:

systemctl restart nginx

Step 7 - Testing Rocket.Chat

Nginx has been configured as reverse proxy for the Rocket.Chat server and we need to update the environment variables to run Rocket.Chat now.

Run Rocket.Chat with the new variables below:

cd /var/www/Rocket.Chat/
export ROOT_URL=https://rocket-chat.co
export MONGO_URL=mongodb://serverku:27017/rocketchat?replicaSet=rs0
export PORT=3000
node main.js

In your web browser, open the URL: rocket-chat.co (or your custom domain nam) - you will be redirected to the https connection.

Create your first admin account by clicking on 'Register a new account' link.

Reference

• https://rocket.chat/docs/installation/manual-installation/ubuntu/