diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..81b77ba
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,34 @@
+==========
+Keepalived
+==========
+
+Keepalived is a routing software written in C. The main goal of this project is to provide simple and robust facilities for loadbalancing and high-availability to Linux system and Linux based infrastructures. Loadbalancing framework relies on well-known and widely used Linux Virtual Server (IPVS) kernel module providing Layer4 loadbalancing. Keepalived implements a set of checkers to dynamically and adaptively maintain and manage loadbalanced server pool according their health. On the other hand high-availability is achieved by VRRP protocol. VRRP is a fundamental brick for router failover. In addition, Keepalived implements a set of hooks to the VRRP finite state machine providing low-level and high-speed protocol interactions. Keepalived frameworks can be used independently or all together to provide resilient infrastructures.
+
+
+Sample pillar
+=============
+
+.. code-block:: yaml
+
+    keepalived:
+      cluster:
+        enabled: True
+        instance:
+          VI_1:
+            priority: 100 (highest priority must be on primary server, different for cluster members)
+            virtual_router_id: 51
+            password: pass
+            address: 192.168.10.1
+            interface: eth0
+          VI_2:
+            priority: 150 (highest priority must be on primary server, different for cluster members)
+            virtual_router_id: 52
+            password: pass
+            address: 10.0.0.5
+            interface: eth1
+ 
+
+Read more
+=========
+
+* https://raymii.org/s/tutorials/Keepalived-Simple-IP-failover-on-Ubuntu.html