diff --git a/docs/changelog.rst b/docs/changelog.rst
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -29,6 +29,7 @@ fixes
   with updating default permissions occurred. RhodeCode detects that now and
   resets default user permission to initial state if there is a need for that.
   Also forces users to set the default value for new forking permission. 
+- #535 improved apache wsgi example configuration in docs
 
 
 1.4.0 (**2012-09-03**)
diff --git a/docs/setup.rst b/docs/setup.rst
--- a/docs/setup.rst
+++ b/docs/setup.rst
@@ -667,12 +667,21 @@ that, you'll need to:
 
 Here is a sample excerpt from an Apache Virtual Host configuration file::
 
-    WSGIDaemonProcess pylons user=www-data group=www-data processes=1 \
+    WSGIDaemonProcess pylons \
         threads=4 \
         python-path=/home/web/rhodecode/pyenv/lib/python2.6/site-packages
     WSGIScriptAlias / /home/web/rhodecode/dispatch.wsgi
     WSGIPassAuthorization On
 
+.. note::
+   when running apache as root please add: `user=www-data group=www-data` 
+   into above configuration
+
+.. note::
+   RhodeCode cannot be runned in multiprocess mode in apache, make sure
+   you don't specify `processes=num` directive in the config
+
+
 Example wsgi dispatch script::
 
     import os