WebsiteCommunityDeveloperFree Trial
Search…
Rocket.Chat Documentation
Getting Support
Development Docs
Quick Start
Deploying Rocket.Chat
Introduction/Prerequisites
Hardware Requirements
Rapid Deployment Methods
Cloud Deployments
Other Deployment Methods
Manual Installation
Rocket.Chat in CentOS
Debian Based Distros
Updating
Updating from 0.x.x to 0.40.0
Updating to 1.0
Nonofficial Methods
Windows 10
Plug-in Deployments
Scaling Rocket.Chat
Accessing Your Workspace
Installing Client Apps
Upgrading Rocket.Chat
Environment Configuration
Guides
User Guides
Administration
Omnichannel
Message Auditing Panel
Message Auditing Log
Rocket.Chat Call Center
App Guides
Mobile Guides
Roles in Rocket.Chat
Security and Compliance Guides
Brand and Visual Guidelines
Enterprise Edition Trial
Rocket.Chat SaaS
Cloud Account
Resources
Frequently Asked Questions
Contributors
How can I help?
Contributor Code of Conduct
Google Summer of Code
Google Season of Docs
Github Sponsorship
Legal
Terms of Service
Master Services Agreement for Self Managed Workspaces
Master Service Agreement for Professional Services
Privacy Policy
Privacy Policy Facebook Messenger
Code of Conduct for our services
GDPR
Censorship and Harmful Content
Guidelines for Law Enforcement
Server Lookup
DMCA Policy
Powered By GitBook
Updating
Updating Manual Installation
Usually you can update Rocket.Chat server pretty easily.
Stop Rocket.Chat service:
1
sudo systemctl stop rocketchat
Copied!
Remove the installation folder, usually in /opt:
1
sudo rm -rf /opt/Rocket.Chat
Copied!
Make sure you have the needed build packages Debian
1
sudo apt-get install -y build-essential graphicsmagick
Copied!
Centos
1
sudo yum install -y gcc-c++ make
Copied!
Update the node version required by Rocket.Chat:
As from Rocket.Chat V4, node version migrated from 12.x.x to 14.x.x
1
sudo n install 14.0.0
Copied!
Download Rocket.Chat latest version:
1
curl -L https://releases.rocket.chat/latest/download -o /tmp/rocket.chat.tgz
Copied!
1
tar -xzf /tmp/rocket.chat.tgz -C /tmp
Copied!
Install it and set right permissions to Rocket.Chat folder:
1
cd /tmp/bundle/programs/server && npm install
Copied!
1
sudo mv /tmp/bundle /opt/Rocket.Chat
Copied!
1
sudo chown -R rocketchat:rocketchat /opt/Rocket.Chat
Copied!
Start the service:
1
sudo systemctl start rocketchat
Copied!
Please also have a look at the installation documentation for your method of deployment to check for paragraphs that refer to the process of updating.
There might be some major changes when we introduce big new features or modifications, you can always take a look on the releases page to see what has been changed, broken or added to Rocket.Chat.
You can see older major changes here:

Caveats on upgrading your standalone Rocket.Chat database

Replicasets

Any version after v1.0.x requires replicasets/oplogging enabled on Mongo.

Upgrading the database

Due to Mongo DB schema changes between versions it is recommended to upgrade your database one Rocket.Chat version at a time to avoid database issues.
Do not backup from one version and try to restore to another eg:
You have Rocket.Chat 0.65.x
Do not try to backup the database and restore to direct to another version e.g. Rocket.Chat 1.2.x
Follow this procedure:
  • Backup DB -> ~/Rocket/Backup/v0.65
  • Upgrade Rocket one version eg 0.65.x -> 0.66.x
  • Check for errors
  • Backup DB -> ~/Rocket/Backup/v0.66
  • Upgrade Rocket one version eg 0.66.x -> 0.67.x
  • Check for errors - if you discover any, stop and fix them or go back to the previous version and start again
  • Repeat
(this is a very good reason to keep reasonably up to date with Rocket.Chat versions)
Please check the Tags or Releases as above for the required version infomation.
Previous
Rocket.Chat on Kali Linux
Next
Updating from 0.x.x to 0.40.0
Last modified 27d ago
Export as PDF
Copy link
Contents
Caveats on upgrading your standalone Rocket.Chat database
Replicasets
Upgrading the database