2 files changed, 25 insertions, 0 deletions

diff --git a/docs/en/index.rst b/docs/en/index.rst
index 34ec7999..590c234a 100644
--- a/docs/en/index.rst
+++ b/docs/en/index.rst
@@ -26,6 +26,7 @@ The main documentation for this application is organized into a couple sections:
    user/faq
    user/installation
    user/migration
+   user/upgrade
    user/create_account
    user/login
    user/configuration
diff --git a/docs/en/user/upgrade.rst b/docs/en/user/upgrade.rst
new file mode 100644
index 00000000..e4735631
--- /dev/null
+++ b/docs/en/user/upgrade.rst
@@ -0,0 +1,24 @@
+Upgrade wallabag
+================
+
+Upgrade on a dedicated web server
+---------------------------------
+
+The last release is published on https://www.wallabag.org/pages/download-wallabag.html. In order to upgrade your wallabag installation and get the last version, run the following commands in you wallabag folder (replace ``2.0.3`` by the last release number):
+::
+
+    git fetch origin
+    git fetch --tags
+    git checkout 2.0.3
+    SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist
+    php bin/console cache:clear --env=prod
+    
+
+Upgrade on a shared hosting 
+---------------------------
+
+Backup your ``app/config/parameters.yml`` file. Extract the archive in your wallabag folder and replace ``app/config/parameters.yml`` with yours.
+
+If you use SQLite, you must also copy your ``data/`` folder inside the new installation.
+
+Empty ``var/cache`` folder.