Add update instructions.

1 files changed, 24 insertions, 0 deletions

diff --git a/INSTALL b/INSTALL
index b77cb1c..dbea971 100644
--- a/INSTALL
+++ b/INSTALL
@@ -303,3 +303,27 @@ The script will mirror the repositories maintaining their directory structures.
 To update the repositories, as a cron job for the 'rhodecode' user, run:
 
     python scripts/update-repos --repos-dir /opt/rhodecode/git_repos
+
+
+Upgrading the Rhodecode instance
+================================
+
+The rhodecode-setup script also supports update of the Rhodecode to the
+specific tag or branch, while doing the reinstallation of the Rhodecode
+automatically. Downgrade of the database is not supported by the Rhodecode
+tools, so bare this in mind when updating to an older version/tag/branch.
+
+To update the system to a specific tag/branch run the following command
+from the rhodecode-config base directory:
+
+    python scripts/rhodecode-setup --rhodecode-config config/production.ini \
+    --rhodecode-usr $USR --rhodecode-branch $TAG \
+    --rhodecode-checkout-dir $CO_DIR --dbname $DB_NAME \
+    --assume-yes --update
+
+   Explaining variables:
+   * $USR: Rhodecode system user (defaults is: rhodecode)
+   * $TAG: Tag or branch in the Rhodecode cloned repository to which
+     the code base will be updated.
+   * $CO_DIR: path to the directory where Rhodecode was previously cloned.
+   * $DB_NAME: Database name for Rhodecode (default is: rhodecode)