# How to upgrade Mattermost from v5.4.0

**URL:** <https://forum.mattermost.com/t/how-to-upgrade-mattermost-from-v5-4-0/22984>\
**Category:** Upgrade\
**Created:** [April 4, 2025, 7:31am UTC](https://forum.mattermost.com/t/how-to-upgrade-mattermost-from-v5-4-0/22984 "2025-04-04T07:31:30Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![thaidv8x](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mattermost.com/thaidv8x/32/8864_2.png) [@thaidv8x](https://forum.mattermost.com/u/thaidv8x)\
**Post date:** [April 4, 2025, 7:31am UTC](https://forum.mattermost.com/t/how-to-upgrade-mattermost-from-v5-4-0/22984/1 "2025-04-04T07:31:30Z")

</div>

Hi  
I have been using mattermost version 5.4.0 for more than 7 years but right now I have plan to migrate to the latest version  
How can I upgrade it properly ? I think I might have issues in database due to huge changes.  
My old mattermost is running on source code  
I have tried to migrate database directly and installed new version but many private channel public all and mattermost did not work properly specially with users and groups.  
I would be thankful if you help me as soon as possible.

---

<div class="post-metadata">

**Author:** ![rtfm98](https://avatars.discourse-cdn.com/v4/letter/r/d9b06d/32.png) [@rtfm98](https://forum.mattermost.com/u/rtfm98)\
**Post date:** [April 4, 2025, 1:15pm UTC](https://forum.mattermost.com/t/how-to-upgrade-mattermost-from-v5-4-0/22984/2 "2025-04-04T13:15:06Z")

</div>

Have you read the docs? The recommended upgrade path is described here: [Prepare to upgrade Mattermost - Mattermost documentation](https://docs.mattermost.com/upgrade/prepare-to-upgrade-mattermost.html)

> For example, if there are three ESR versions ESR1, ESR2, and ESR3, upgrading from ESR1 to ESR2, and then ESR2 to ESR3 will ensure backwards compatibility, but not from ESR1 to ESR3 directly.

and

> In the case of delayed upgrades, we recommend upgrading to the closest ESR version first, and from there to the next ESR. Do not attempt to directly upgrade to the latest version as it might break backwards compatibility of the older nodes in the cluster during the upgrade.

Don’t forget to read the upgrade notices: [Important Upgrade Notes - Mattermost documentation](https://docs.mattermost.com/upgrade/important-upgrade-notes.html)

---

<div class="post-metadata">

**Author:** ![john.oliver](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mattermost.com/john.oliver/32/6436_2.png) [@john.oliver](https://forum.mattermost.com/u/john.oliver)\
**Post date:** [April 4, 2025, 3:11pm UTC](https://forum.mattermost.com/t/how-to-upgrade-mattermost-from-v5-4-0/22984/3 "2025-04-04T15:11:33Z")

</div>

@rtfm98 is dead on. [Version archive - Mattermost documentation](https://docs.mattermost.com/about/version-archive.html) is how you’d find each step in the process.