diff --git a/docs/upgrade.rst b/docs/upgrade.rst
new file mode 100644
--- /dev/null
+++ b/docs/upgrade.rst
@@ -0,0 +1,32 @@
+.. _upgrade:
+
+Upgrade
+=======
+
+Upgrade from Cheese Shop
+------------------------
+
+Easiest way to upgrade ``rhodecode`` is to run::
+
+ easy_install -U rhodecode
+
+Or::
+
+ pip install --upgrade rhodecode
+
+
+Then make sure You run from the installation directory
+
+::
+ 
+ paster make-config RhodeCode production.ini
+ 
+This will display any changes made from new version of RhodeCode To your
+current config. And tries to do an automerge.
+
+
+.. _virtualenv: http://pypi.python.org/pypi/virtualenv  
+.. _python: http://www.python.org/
+.. _mercurial: http://mercurial.selenic.com/
+.. _celery: http://celeryproject.org/
+.. _rabbitmq: http://www.rabbitmq.com/
\ No newline at end of file