diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..bf44925
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,121 @@
+=======
+MongoDB
+=======
+
+MongoDB (from "humongous") is an open-source document database, and the leading NoSQL database. Written in C++.
+
+Available states
+================
+
+.. contents::
+    :local:
+
+``mongodb.server``
+--------------------
+
+Setup MongoDB server
+
+Available metadata
+==================
+
+.. contents::
+    :local:
+
+``metadata.mongodb.server.single``
+----------------------------------
+
+Single-node MongoDB setup
+
+``metadata.mongodb.server.cluster``
+-----------------------------------
+
+Clustered MongoDB setup
+
+Configuration parameters
+========================
+
+
+Example reclass
+===============
+
+Setup MongoDB with database for ceilometer.
+
+.. code-block:: yaml
+
+     classes:
+     - service.mongodb.server.cluster
+     parameters:
+        _param:
+          mongodb_server_replica_set: ceilometer
+          mongodb_ceilometer_password: cloudlab
+          mongodb_admin_password: cloudlab
+          mongodb_shared_key: xxx
+        mongodb:
+          server:
+            database:
+              ceilometer:
+                enabled: true
+                password: ${_param:mongodb_ceilometer_password}
+                users:
+                -  name: ceilometer
+                   password: ${_param:mongodb_ceilometer_password}
+
+Sample pillars
+==============
+
+Simple single server
+
+.. code-block:: yaml
+
+    mongodb:
+      server:
+        enabled: true
+        bind:
+          address: 0.0.0.0
+          port: 27017
+        admin:
+          username: admin
+          password: magicunicorn
+        database:
+          dbname:
+            enabled: true
+            encoding: 'utf8'
+            users:
+            - name: 'username'
+              password: 'password'
+
+Cluster of 3 nodes
+
+.. code-block:: yaml
+
+    mongodb:
+      server:
+        enabled: true
+        admin:
+          user: admin
+          password: magicunicorn
+        master: mongo01
+        members:
+          - host: 192.168.1.11
+            priority: 2
+          - host: 192.168.1.12
+          - host: 192.168.1.13
+        replica_set: default
+        shared_key: magicunicorn
+
+It's possible that first Salt run on master node won't pass correctly before
+all slave nodes are up and ready.
+Simply run salt again on master node to setup cluster, databases and users.
+
+To check cluster status, execute following:
+
+.. code-block:: bash
+
+    mongo 127.0.0.1:27017/admin -u admin -p magicunicorn --eval "rs.status()"
+
+Read more
+=========
+
+* http://docs.mongodb.org/manual/
+* http://docs.mongodb.org/manual/tutorial/install-mongodb-on-ubuntu/
+* https://www.linode.com/docs/databases/mongodb/creating-a-mongodb-replication-set-on-ubuntu-12-04-precise