diff --git a/debian/README.Debian b/debian/README.Debian
index d414849dbd..4b0e74fa27 100644
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -26,5 +26,16 @@ You can find the list of gems required by gitlab and their corresponding
 package versions in debian at
 http://debian.fosscommunity.in/status/?appname=gitlab&sort=satisfied
 
-6. vendored js files: some embedded javascript files in vendor/assets/javascripts are
-replaced by their packaged verion.
+6. vendored js files: some embedded javascript files in
+vendor/assets/javascripts are replaced by their packaged verion.
+
+7. root directory of rails is read only (/usr/share/gitlab); following symbolic
+links are added to enable write access to gitlab app
+
+> config -> /etc/gitlab
+> Gemfile.lock -> /var/lib/gitlab/Gemfile.lock
+> log -> /var/log/gitlab
+> public -> /var/lib/gitlab/public
+> tmp -> /run/gitlab
+> shared/cache -> /var/lib/gitlab/cache
+> /usr/share/gitlab/.secret -> /var/lib/gitlab/.secret