Updating your Rocket.Chat workspace is a straightforward process when you follow the necessary preparation steps. This guide walks you through the essential actions to ensure a smooth and successful Rocket.Chat update.
1. Plan your update
Before you begin, take a moment to plan your update. This is the most crucial step for a successful process.
Check release notes: Each new version of Rocket.Chat comes with features, bug fixes, and security improvements. Review the release notes for your target version and identify any breaking changes that may impact your users.
Select a supported target version: Make sure the version you are updating to is actively supported. See the Version Durability documentation for support timelines.
Avoid skipping versions: Always update Rocket.Chat sequentially, especially across major versions. For example, to update from 1.x.x to 4.x.x, you must first upgrade to 2.x.x, then 3.x.x, and finally 4.x.x. Skipping versions can cause severe compatibility issues.
2. Back up your data
Always create a full backup of your Rocket.Chat instance before starting an update. This should include both your database and any custom configurations. A backup ensures you can restore your workspace if something goes wrong during the update. Refer to the MongoDB Backup and Restore guide for detailed instructions.
3. Update Rocket.Chat
Once you've completed your preparations, you can proceed with the update. The steps to update Rocket.Chat vary and depend entirely on how your workspace is deployed. Select and follow the guide that matches your deployment method:
Docker: See the Update Rocket.Chat on Docker guide.
Kubernetes: Visit the Update Rocket.Chat on Kubernetes guide.
Podman: Refer to Update Rocket.Chat on Podman.
Other methods
DigitalOcean: Go to Update Rocket.Chat on Digital Ocean.
Snaps: See the Update Rocket.Chat on Snaps guide.
Ubuntu: Visit the Update Rocket.Chat on Ubuntu guide.
CentOS: Go to Update Rocket.Chat on CentOS guide.
Debian: Visit the Update Rocket.Chat on Debian guide.
Windows: Refer to Update Rocket.Chat on Windows.
AWS: See the Update Rocket.Chat on AWS
4. Update MongoDB
Each Rocket.Chat release is compatible with a specific range of MongoDB versions. After updating Rocket.Chat, it’s important to verify whether your MongoDB version is still compatible.
To verify this,
See the Engine versions section in the GitHub release notes for the required MongoDB version of your release.
You can also find detailed information on the supported MongoDB versions for each release in the MongoDB support requirements documentation.
If your MongoDB version is unsupported, update it to the required version to ensure stability and prevent issues.
See the following flowchart 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:
To update your desktop and mobile apps, refer to Install Desktop & Mobile App.