diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..eaf9273
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,84 @@
+========
+Collectd
+========
+
+Collectd is a daemon which collects system performance statistics periodically and provides mechanisms to store the values in a variety of ways, for example in RRD files. 
+
+Sample pillars
+==============
+
+Send data over TCP to Graphite Carbon (old way plugins)
+
+.. code-block:: yaml
+
+    collectd:
+      client:
+        enabled: true
+        read_interval: 60
+        plugins:
+        - name: cpu
+        - name: df
+        - name: disk
+        - name: entropy
+        - name: interface
+        - name: load
+        - name: memory
+        - name: processes
+        - name: swap
+        - name: uptime
+        - name: users
+        - name: write_graphite
+          host: carbon1.comain.com
+          port: 2003
+
+Gather libvirt data from local KVM
+
+.. code-block:: yaml
+
+    collectd:
+      client:
+        enabled: true
+        read_interval: 60
+        plugins:
+        - name: cpu
+        - name: libvirt
+          connection: 'qemu:///system'
+
+Send data over AMQP
+
+.. code-block:: yaml
+
+    collectd:
+      client:
+        enabled: true
+        read_interval: 60
+        plugins:
+        - name: cpu
+        - name: users
+        - name: amqp
+          host: broker1.comain.com
+          port: 5672
+          user: monitor
+          password: amqp-pwd
+          virtual_host: '/monitor'
+
+Send data over carbon
+
+.. code-block:: yaml
+
+    collectd:
+      client:
+        enabled: true
+        backend:
+          carbon:
+            engine: carbon
+            host: metrics.domain.com
+            port: 2003
+
+Read more
+=========
+
+* http://collectd.org/documentation.shtml
+* http://www.canopsis.org/2013/02/collectd-graphite/
+* http://collectd.org/documentation/manpages/collectd.conf.5.shtml#plugin_libvirt
+* http://libvirt.org/uri.html#URI_qemu