diff --git a/development.ini b/development.ini
--- a/development.ini
+++ b/development.ini
@@ -50,7 +50,8 @@ asyncore_use_poll = True
 
 ## GUNICORN ##
 #use = egg:gunicorn#main
-## number of process workers. Don't change that to more than 1
+## number of process workers. You must set `instance_id = *` when this option
+## is set to more than one worker
 #workers = 1
 ## process name
 #proc_name = rhodecode
diff --git a/production.ini b/production.ini
--- a/production.ini
+++ b/production.ini
@@ -50,7 +50,8 @@ asyncore_use_poll = True
 
 ## GUNICORN ##
 #use = egg:gunicorn#main
-## number of process workers. Don't change that to more than 1
+## number of process workers. You must set `instance_id = *` when this option
+## is set to more than one worker
 #workers = 1
 ## process name
 #proc_name = rhodecode
diff --git a/rhodecode/config/deployment.ini_tmpl b/rhodecode/config/deployment.ini_tmpl
--- a/rhodecode/config/deployment.ini_tmpl
+++ b/rhodecode/config/deployment.ini_tmpl
@@ -50,7 +50,8 @@ asyncore_use_poll = True
 
 ## GUNICORN ##
 #use = egg:gunicorn#main
-## number of process workers. Don't change that to more than 1
+## number of process workers. You must set `instance_id = *` when this option
+## is set to more than one worker
 #workers = 1
 ## process name
 #proc_name = rhodecode