Updating Rocket.Chat

Rocket.Chat 6.0 is our most secure and scalable version yet. It includes 10 security patches, 9 brand-new features, and 25+ overall platform enhancements. Visit our website to learn more about what’s new in this latest version. Update now!

Keeping your Rocket.Chat installation up-to-date is essential to ensure that you have access to the latest features, bug fixes, and security enhancements. This guide will walk you through the process of updating Rocket.Chat across various deployment methods.

Before you Update

To prepare for a successful Rocket.Chat upgrade, it's vital to adhere to specific guidelines. Start by thoroughly understanding the System Requirements and carefully reading the release notes specific to your target version.

Backup your data

Always perform a full backup of your Rocket.Chat instance, including the database and any custom configurations. This ensures that you can revert to a working state in case of any issues during the update.

Avoid skipping major versions

When you upgrade from one major version to another, it is important to follow a sequential path and not skip any intermediate major versions. This is because each major version is a significant change, and skipping intermediate versions can lead to compatibility problems or unexpected behavior.

For example, if you are upgrading your workspace from version 1.x.x to version 4.x.x, you should follow this path: 1.x.x -> 2.x.x -> 3.x.x -> 4.x.x.

We recommend that you upgrade to the latest version of the next release from your current version. Here is the recommended path:

Skipping intermediate major versions, such as upgrading directly from 1.x.x to 4.x.x, can lead to problems because the software in 4.x.x may not be compatible with the data or settings that you have in 1.x.x.

See our upgrade version path flowchart and demo for a more detailed workflow on updating your workspace from the oldest version (1.x.x) with MMAP to the latest version with the supported MongoDB release.

Upgrade Version Path

Updating Rocket.Chat

Updating your Rocket.Chat workspace to a new version involves several steps, which can vary depending on the deployment method you're using.

1. If you deployed your workspace with Docker, follow the update Rocket.Chat on docker guide.
2. If you deployed your workspace with Snaps, see the update Rocket.Chat on snaps guide.
3. If you deployed your workspace following the manual installations, continue with the following steps:

Manual installation includes Rocket.Chat deployment on CentOS and Debian distributions.

To update the Rocket.Chat server deployed via manual installation,

• Stop Rocket.Chat service:

sudo systemctl stop rocketchat

• Remove the installation folder, usually in /opt

sudo rm -rf /opt/Rocket.Chat

• Ensure you have the needed build packages for Debian.

sudo apt-get install -y build-essential graphicsmagick

• Update the node version required by Rocket.Chat. Check the release notes for the supported engine versions for MongoDB and NodeJs, and install as recommended.

sudo n install <x.x.x>

• Download the latest version of Rocket.Chat:

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

tar -xzf /tmp/rocket.chat.tgz -C /tmp

• Install it and set the proper permissions to Rocket.Chat folder with these commands:

cd /tmp/bundle/programs/server && npm install

sudo mv /tmp/bundle /opt/Rocket.Chat

sudo chown -R rocketchat:rocketchat /opt/Rocket.Chat

• Start the Rocket.Chat service:

sudo systemctl start rocketchat

If you have any concerns or issues with updating Rocket.Chat, see Updating Rocket.Chat FAQ

Upgrading MongoDB

Refer to MongoDB versions and learn more about the supported MongoDB versions for your Rocket.Chat workspace and how to upgrade.