diff --git a/README.md b/README.md
index ff47da8..beb8c16 100644
--- a/README.md
+++ b/README.md
@@ -133,3 +133,11 @@ Remove all the data and settings of your Mattermost instance
 ```
 sudo rm -rf volumes
 ```
+
+# Upgrading from mattermost-docker
+
+For upgrading from deprecated [mattermost-docker](https://github.com/mattermost/mattermost-docker) please follow the instructions [here](https://github.com/mattermost/docker/blob/main/scripts/UPGRADE.md). 
+This will upgrade the mattermost-docker postgres database and the mattermost application. The upgrade script aims to ease the migration to this repository's approach which does not use customized docker images. 
+This repository will be maintained for future releases.  
+
+For any comments, help needed and/or questions, please don't hesitate to write us in this issue: https://github.com/mattermost/mattermost-docker/issues/489