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 document will outline some basic guidelines to follow while preparing for a successful Rocket.Chat update.
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.
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 the update version path flowchart below and the demo for a detailed walkthrough on updating your workspace from older versions (such as 1.x.x with MMAP) to the latest version with the supported MongoDB release.
Each deployment method includes specific steps for updating your Rocket.Chat workspace in their respective documentation. To update your Rocket.Chat workspace, follow the instructions for your deployment method:
Docker: See the Update Rocket.Chat on Docker guide.
Kubernetes: Visit the Update Rocket.Chat on Kubernetes guide.
Snaps: See the Update Rocket.Chat on Snaps guide.
Manual and other deployment methods: Refer to the relevant documentation for your deployment method.
To update your desktop and mobile apps, refer to Install Desktop & Mobile App .
Updating MongoDB
Refer to MongoDB version support to learn more about the supported MongoDB versions for your Rocket.Chat workspace and how to update.