diff --git a/content/os/v1.x/en/upgrading/_index.md b/content/os/v1.x/en/upgrading/_index.md
index 05658c050f8..beedfcdd821 100644
--- a/content/os/v1.x/en/upgrading/_index.md
+++ b/content/os/v1.x/en/upgrading/_index.md
@@ -7,7 +7,7 @@ If RancherOS has released a new version and you want to learn how to upgrade you
 
 Since RancherOS is a kernel and initrd, the upgrade process is downloading a new kernel and initrd, and updating the boot loader to point to it. The old kernel and initrd are not removed. If there is a problem with your upgrade, you can select the old kernel from the Syslinux bootloader.
 
-To see all of our releases, please visit our [releases page](https://github.com/rancher/os/releases) in GitHub.
+Before upgrading to any version, please review the release notes on our [releases page](https://github.com/rancher/os/releases) in GitHub to review any updates in the release.
 
 > **Note:** If you are using [`docker-machine`]({{< baseurl >}}/os/v1.x/en/installation/running-rancheros/workstation/docker-machine/) then you will not be able to upgrade your RancherOS version. You need to delete and re-create the machine.
 
@@ -135,3 +135,30 @@ rancher:
     url: https://releases.rancher.com/os/releases.yml
     image: rancher/os
 ```
+
+### Upgrade Notes for v1.4.0+
+
+If you are upgrading to v1.4.0+, please review these notes that could alter your RancherOS settings.
+
+Due to changes in the location of user-docker's data-root, after upgrading to v1.4.0+, you must move or copy the files of user-docker's data-root. If you do not do this, your data will *NOT* be available. 
+
+```
+#!/bin/bash
+
+old_docker_root="/proc/1/root/var/lib/docker"
+new_docker_root="/proc/1/root/var/lib/user-docker"
+
+system-docker stop docker
+cp -a $old_docker_root/* $new_docker_root
+system-docker start docker
+```
+
+If you had another bridge IP set for system-docker, you may need to explicitly set it again depending on your upgrade path. Before re-setting it, you can confirm if it's set. 
+
+```
+# Check to see if docker bridge IP is set
+$ sudo ros config get rancher.system_docker.bip
+
+# If it is no longer set, re-set the setting
+$ sudo ros config set rancher.system_docker.bip 10.0.0.1/16
+```