# Rocket.Chat Version / DB Upgrade

**URL:** <https://forums.rocket.chat/t/rocket-chat-version-db-upgrade/22792>\
**Category:** Community Support\
**Created:** [March 20, 2026, 8:27am UTC](https://forums.rocket.chat/t/rocket-chat-version-db-upgrade/22792 "2026-03-20T08:27:24Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![cat](https://avatars.discourse-cdn.com/v4/letter/c/d07c76/32.png) [@cat](https://forums.rocket.chat/u/cat)\
**Post date:** [March 20, 2026, 8:27am UTC](https://forums.rocket.chat/t/rocket-chat-version-db-upgrade/22792/1 "2026-03-20T08:27:24Z")

</div>

## Rocket.Chat Upgrade Issue (MongoDB 7 → 8, 8.1.1 → 8.2.1)

### Current setup

- Rocket.Chat: 8.1.1

- MongoDB: 7.0

- Running stable with full data (users, channels, messages)

### Goal

Upgrade to:

- Rocket.Chat 8.2.1

- MongoDB 8

### Test setup

- MongoDB 8

- Rocket.Chat 8.1.1 works fine on MongoDB 8

### Problem

After upgrading Rocket.Chat to 8.2.1 (changing only the image in docker-compose):

- Rocket.Chat starts

- Setup wizard appears

- Asked to create a new admin account

- Existing data is not recognized

### What I tried

1. Direct upgrade (8.1.1 → 8.2.1)  
→ Setup wizard appears

2. Backup & restore:

3. Combinations:

### Question

Is there a required migration step when upgrading from Rocket.Chat 8.1.1 (MongoDB 7) to 8.2.1 (MongoDB 8)?

How can I upgrade without losing or reinitializing the existing data?

---

<div class="post-metadata">

**Author:** ![reetp](https://sea1.discourse-cdn.com/flex021/user_avatar/forums.rocket.chat/reetp/32/5546_2.png) [@reetp](https://forums.rocket.chat/u/reetp)\
**Post date:** [March 20, 2026, 4:14pm UTC](https://forums.rocket.chat/t/rocket-chat-version-db-upgrade/22792/2 "2026-03-20T16:14:29Z")

</div>

You only need to post once.

Have you read all the docs?

Have you read all the docker mongo docs?

Did you read the release notes BEFORE upgrading and do what they told you? If you didn’t breakages may occur.

> ….and workspaces must upgrade to MongoDB 8.2 before moving to Rocket.Chat v8.0.0, with a full backup strongly recommended.

Think that is quite clear?

Have you got good backups? You may need them.

Full text here.

> **[Release 8.0.0 · RocketChat/Rocket.Chat](https://github.com/RocketChat/Rocket.Chat/releases/tag/8.0.0)**
>
> Summary
> Breaking changes
> This release introduces a wide set of breaking changes focused on removing deprecated, end-of-life, and legacy functionality. Support for MongoDB 5.0 and 6.0 has been disco...

---

<div class="post-metadata">

**Author:** ![cat](https://avatars.discourse-cdn.com/v4/letter/c/d07c76/32.png) [@cat](https://forums.rocket.chat/u/cat)\
**Post date:** [March 25, 2026, 11:05am UTC](https://forums.rocket.chat/t/rocket-chat-version-db-upgrade/22792/3 "2026-03-25T11:05:10Z")

</div>

Hey sorry for posting twice!

ive read all the release notes and patch notes.

I tried launching rocket.chat on a local machine to test the migration first, i got MongoDB to version 8 on rocketchat. 8.1.1, but when i try to install 8.2.x, i get the /setup-wizard all the time.

Thank you for ur answer!

---

<div class="post-metadata">

**Author:** ![reetp](https://sea1.discourse-cdn.com/flex021/user_avatar/forums.rocket.chat/reetp/32/5546_2.png) [@reetp](https://forums.rocket.chat/u/reetp)\
**Post date:** [March 25, 2026, 11:25am UTC](https://forums.rocket.chat/t/rocket-chat-version-db-upgrade/22792/4 "2026-03-25T11:25:02Z")

</div>

More like a docker issue than a Rocket one.

Sounds like your db didn’t upgrade correctly. Logs are your friend…. What do they say? Both Rocket & Mongo?

You need to check the mongo docs on upgrading the db. If you didn’t set it you might want to look for :

```auto
setFeatureCompatibilityVersion

```