diff --git a/README.rst b/README.rst
index e295f7a..c1e7f0c 100644
--- a/README.rst
+++ b/README.rst
@@ -8,6 +8,15 @@ to skim through format.
 For more information and a working demo board visit `getpinry.com`_.
 
 
+Upgrade from 1.x
+------------------
+
+For source code users:
+
+Read our `online doc <doc/upgrade_from_1.x.md>`_ about how to upgrade to 2.x
+
+For docker users, please contact us for help: )
+
 Requirements
 ------------
 
diff --git a/doc/upgrade_from_1.x.md b/doc/upgrade_from_1.x.md
new file mode 100644
index 0000000..96d64a9
--- /dev/null
+++ b/doc/upgrade_from_1.x.md
@@ -0,0 +1,59 @@
+Guide of Upgrade from 1.x to 2.x
+---------------------------------------
+
+If you have Pinry installed by srouce code, it's easy for
+you to upgrade from 1.x to 2.x, just follow these steps.
+
+At first you should checkout the old branch.
+
+```bash
+# it is not required if you are currently the old version
+git checkout 1.x version
+
+# install and enter the shell
+pipenv install 
+pipenv shell
+
+# Upgrade to lastest version of django-images
+
+pip install -U git+https://github.com/mirumee/django-images.git
+python manage.py makemigrations
+python manage.py migrate --fake-initial
+
+# clean action
+pip uninstall django-images
+
+# It will ask if you want to remove an extra file named like
+# Uninstalling django-images-0.4.3:
+# -------------------------------------------
+#  Would remove:
+#    /path_to_your_python_packages/django_images-0.4.3.dist-info/*
+#    /path_to_your_python_packages/django_images/*
+#  Would not remove (might be manually added):
+#    /path_to_your_python_packages/django_images/migrations/0002_auto_20180826_0845.py
+# Proceed (y/n)? 
+# ------------------------------------------
+# Please remove the file it by hand
+rm /path_to_your_python_packages/django_images/migrations/0002_auto_20180826_0845.py
+
+# exit pipenv's virtualenv
+exit
+```
+
+Ant then you should checkout to version 2.x (our current master) 
+
+```bash
+# If you are not the lastest version ,just call "git pull --rebase"
+# to upgrade to lastest version of Pinry (2.x)
+git checkout master
+make install
+make migrate
+
+# Try to run as development server
+make serve
+
+# If no error occurs, just enjoy it
+
+```
+
+And now, you can just run your server in the way you like.