diff --git a/README.rst b/README.rst
index 04ccd70..9c06ca0 100644
--- a/README.rst
+++ b/README.rst
@@ -548,6 +548,39 @@
           quota_consumers: -1
           quota_cas: -1
 
+
+Change files/directories permissions for barbican service:
+=======================================
+In order to change file permissions the following should be set:
+
+'files' - block to set permissions for files.
+- full path to file
+- user ( default value is 'root' ) this parameter is optional.
+- group ( default value is 'barbican' ) this parameter is optional
+- mode ( default value is '0640' ) this parameter is optional
+
+'directories' - block to set permissions for directories.
+- full path to directory
+- user ( default value is 'root' ) this parameter is optional
+- group ( default value is 'barbican' ) this parameter is optional
+- mode ( default value is '0750' ) this parameter is optional
+
+.. code-block:: yaml
+
+    barbican:
+      files:
+        /etc/barbican/barbican.conf:
+          user: 'root'
+          group: 'barbican'
+          mode: '0750'
+      directories:
+        /etc/barbican:
+          user: 'root'
+          group: 'barbican'
+          mode: '0750'
+
+
+
 Read more
 =========