As of December 15, 2023, Rocket.Chat has ceased support for connections from cloud services and official mobile/desktop apps to workspaces running legacy versions outside our support window. Users on unsupported legacy servers are advised to upgrade to the latest Rocket.Chat version to ensure continued access to cloud, mobile, and desktop applications. Each Rocket.Chat version is supported for six months post-release. See Version Durability for details on the support dates of each release version.
Keeping your Rocket.Chat installation up-to-date is crucial for accessing the latest features, bug fixes, and security improvements. This guide will outline some basic guidelines to follow while preparing for a successful Rocket.Chat update.
Refer to the documentation for your deployment method to find specific instructions on how to update your workspace.
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 you can revert to a working state in case of any issues during the update.
Avoid skipping major versions: When updating from one major version to another, it is important to follow a sequential path and not skip any intermediate major versions.
For example, if you are updating your workspace from version 1.x.x to version 4.x.x, we recommend that you follow this path: 1.x.x -> 2.x.x -> 3.x.x -> 4.x.x. Like so:
Following the recommended path above enables you to update to the latest version of the next release from your current version until you get to your preferred version without missing any significant changes.
Skipping intermediate major versions, such as updating directly from
1.x.xto4.x.x, can lead to problems because the software in4.x.xmay not be compatible with the data or settings that you have in1.x.x.
See our update 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.
Update version path
Updating MongoDB
Refer to MongoDB version support and learn more about the supported MongoDB versions for your Rocket.Chat workspace and how to update.
Each deployment method provides specific steps for updating your Rocket.Chat workspace in their respective documentation. Refer to the relevant documentation for detailed update instructions specific to your deployment.