Upgrading Rocketchat: What is the preferred method?



We currently utilize rocketchat in an air-gapped environment and we’re wanting to upgrade to 5.4. Just trying to figure out the best and painless way to upgrade? I’ve read that in order to upgrade, you cannot skip multiple versions. Would it be easier to deploy out 5.4 (on rhel8) and utilize it that way or to just upgrade in order? We’d like to keep the history of chat rooms, private messages, etc. so would migrating the database be do-able? Would the mongodb being different versions cause issues of exporting and then importing into 5.4?

Thanks in advance.

Server Setup Information

  • Version of Rocket.Chat Server: 3.13
  • Operating System: rhel7
  • Deployment Method:
  • Number of Running Instances:
  • DB Replicaset Oplog:
  • NodeJS Version:
  • MongoDB Version: 4.0.23
  • Proxy:
  • Firewalls involved:

Any additional Information

Hello There,

Upgrading directly from 3.13 to 5.4 won’t work. You first have to upgrade to 4.8.7 and then to 5.4.
Once you have upgraded to 5.4, then you can also upgrade the MongoDB version as well, i.e from 4.x to 5.0.

If you need any help in upgrading Rocket Chat, you can reach out to us at:


We can do the upgrade with all your data intact for a very reasonable cost.

We also provide fully managed Rocket Chat cloud hosting.