Deploy with Ubuntu
Preparation Steps
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.
MongoDB
Please refer to the official MongoDB documentation on how to install MongoDB on Ubuntu.
NodeJS
Follow the official guide to install NodeJS on Ubuntu. You can also use third-party tools like nvm or n.
When deploying MongoDB, it is crucial to secure MongoDB instances and close all MongoDB ports from public access. Unsecured instances can lead to significant security vulnerabilities. Your vigilance in these practices is essential for maintaining the integrity and safety of your systems.
Install Rocket.Chat on Ubuntu
Install the required packages/dependencies.
Download and extract the latest release of Rocket.Chat.
Extract the Rocket.Chat server files using these commands:
When executing npm install
, it is recommended to operate using a non-root account. Alternatively, you can utilize the npm install --unsafe-perm --production
command. This approach eliminates the necessity for building libc or upgrading the host system.
Move the extracted files to the /opt directory.
This guide uses the /opt directory. However, you can choose your preferred directory.
Configure the Rocket.Chat service
Add the rocketchat user and set the right permissions on the Rocket.Chat folder.
Depending on how you install NodeJS, the binary path may be different. Save the path to a variable.
Now, save the systemd service file.
The command above will create a barebone service file; this service file is what systemd will use to start your Rocket.Chat daemon/process.
Passing environment variables
Pass some environment variables to the running process. See Rocket.Chat environmental variables for more details. To update the Rocket.Chat file, run the following command :
Update the text editor with the information below and save.
MongoDB Configuration
Open the MongoDB config file (
/etc/mongod.conf
) in your preferred text editor.
Set the storage engine to
wiredTiger
.
Enable replication, and name the replicaset
rs01
.
The MongoDB replica set is mandatory for Rocket.Chat > 1.0.0.
Your MongoDB config file should look something like the following:
Read the official documentation for a complete list of available MongoDB config options.
Start MongoDB with the following command:
Then, initiate replica set with this command:
You can start your Rocket.Chat workspace now using this command:
Configure your Rocket.Chat server
To access your Rocket.Chat workspace, open a web browser and navigate to the specified ROOT URL (http://your-host-name.com-as-accessed-from-internet:3000). Follow the configuration prompts to configure your workspace.
Optional Configurations
Last updated