diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..c663c12
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,16 @@
+
+===================
+baremetal-simulator
+===================
+
+Formula to simulate HW nodes by libvirt VMs and virtualbmc
+
+Sample pillar
+==============
+
+Enable baremetal-simulator
+
+.. code-block:: yaml
+
+  barmeetal_simulator:
+    enabled: true