diff --git a/docker/images/n8n/README.md b/docker/images/n8n/README.md
index edd49c933..658785ef5 100644
--- a/docker/images/n8n/README.md
+++ b/docker/images/n8n/README.md
@@ -21,6 +21,7 @@ is there currently not much documentation. That will hopefully change soon.
 - [Persist data](#persist-data)
 - [Passing Senstive Data via File](#passing-senstive-data-via-file)
 - [What does n8n mean and how do you pronounce it](#what-does-n8n-mean-and-how-do-you-pronounce-it)
+- [Upgrading](#upgrading)
 - [License](#license)
 
 
@@ -208,6 +209,13 @@ did not hear anybody complain there. So I guess it should be ok.
 
 
 
+## Upgrading
+
+Before you upgrade to the latest version make sure to check here if there are any breaking changes which concern you:
+[Breaking Changes](https://github.com/n8n-io/n8n/blob/master/packages/cli/BREAKING-CHANGES.md)
+
+
+
 ## License
 
 n8n is licensed under [**Apache 2.0 with Commons Clause**](https://github.com/n8n-io/n8n/blob/master/packages/cli/LICENSE.md)