diff --git a/docs/index.rst b/docs/index.rst
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -23,7 +23,8 @@ Users Guide
    usage/git_support
    usage/statistics
    usage/backup
-   
+   usage/debugging
+
 **Develop**
 
 .. toctree::
diff --git a/docs/usage/debugging.rst b/docs/usage/debugging.rst
new file mode 100644
--- /dev/null
+++ b/docs/usage/debugging.rst
@@ -0,0 +1,25 @@
+.. _debugging:
+
+===================
+DEBUGGING RHODECODE
+===================
+
+If you encountered problems with RhodeCode here are some instructions how to
+possibly debug them.
+
+** First make sure you're using the latest version available.**
+
+enable detailed debug
+---------------------
+
+RhodeCode uses standard python logging modules to log it's output.
+By default only loggers with INFO level are displayed. To enable full output
+change `level = DEBUG` for all logging handlers in currently used .ini file. 
+After this you can check much more detailed output of actions happening on 
+RhodeCode system.
+
+
+enable interactive debug mode
+-----------------------------
+
+To enable interactive debug mode simply