diff --git a/README.rst b/README.rst
new file mode 100755
index 0000000..9ba2473
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,150 @@
+
+==========
+PostgreSQL
+==========
+
+PostgreSQL, often simply Postgres, is an object-relational database management system available for many platforms including Linux, FreeBSD, Solaris, Microsoft Windows and Mac OS X. It is released under the PostgreSQL License, which is an MIT-style license, and is thus free and open source software. PostgreSQL is developed by the PostgreSQL Global Development Group, consisting of a handful of volunteers employed and supervised by companies such as Red Hat and EnterpriseDB.
+
+Support
+=======
+
+* required by: [redmine](../master/redmine)
+* service versions: 9.1
+* operating systems: Ubuntu 12.04
+
+Sample pillars
+==============
+
+Single database server with empty database
+------------------------------------------
+
+.. code-block:: yaml
+
+    postgresql:
+      server:
+        enabled: true
+        version: 9.1
+        bind:
+          address: 127.0.0.1
+          port: 5432
+          protocol: tcp
+        clients:
+        - 127.0.0.1
+        database:
+          name: 'databasename'
+          encoding: 'UTF8'
+          locale: 'cs_CZ'
+          user:
+            name: 'username'
+            password: 'password'
+            host: 'localhost'
+            rights: 'all privileges'
+
+Single database server with prepopulated database
+-------------------------------------------------
+
+.. code-block:: yaml
+
+    postgresql:
+      server:
+        enabled: true
+        version: 9.1
+        bind:
+        - address: 127.0.0.1
+          port: 5432
+          protocol: tcp
+        clients:
+        - 127.0.0.1
+        database:
+          name: 'databasename'
+          encoding: 'UTF8'
+          locale: 'cs_CZ'
+          initial_data:
+            engine: backupninja
+            source: backup.host
+            host: original-host-name
+            database: original-database-name
+          user:
+            name: 'username'
+            password: 'password'
+            host: 'localhost'
+            rights: 'all privileges'
+
+User with createdb privileges
+-----------------------------
+
+.. code-block:: yaml
+
+    postgresql:
+      server:
+        enabled: true
+        version: 9.1
+        bind:
+          address: 127.0.0.1
+          port: 5432
+          protocol: tcp
+        clients:
+        - 127.0.0.1
+        database:
+          name: 'databasename'
+          encoding: 'UTF8'
+          locale: 'cs_CZ'
+          user:
+            name: 'username'
+            password: 'password'
+            host: 'localhost'
+            createdb: true
+            rights: 'all privileges'
+
+
+PostgreSQL extensions
+---------------------
+
+.. code-block:: yaml
+
+    postgresql:
+      server:
+        enabled: true
+        version: 9.1
+        bind:
+          address: 127.0.0.1
+          port: 5432
+          protocol: tcp
+        clients:
+        - 127.0.0.1
+        database:
+          name: 'databasename'
+          encoding: 'UTF8'
+          locale: 'cs_CZ'
+          user:
+            name: 'username'
+            password: 'password'
+            host: 'localhost'
+            createdb: true
+            rights: 'all privileges'
+          extension:
+            postgis_topology:
+            fuzzystrmatch:
+            postgis_tiger_geocoder:
+            postgis:
+
+## Sample usage
+
+Init database cluster with given locale
+
+    sudo su - postgres -c "/usr/lib/postgresql/9.3/bin/initdb /var/lib/postgresql/9.3/main --locale=C"
+
+Convert PostgreSQL cluster from 9.1 to 9.3
+
+    sudo su - postgres -c '/usr/lib/postgresql/9.3/bin/pg_upgrade -b /usr/lib/postgresql/9.1/bin -B /usr/lib/postgresql/9.3/bin -d /var/lib/postgresql/9.1/main/ -D /var/lib/postgresql/9.3/main/ -O "-c config_file=/etc/postgresql/9.3/main/postgresql.conf" -o "-c config_file=/etc/postgresql/9.1/main/postgresql.conf"'
+
+Ubuntu on 14.04 on some machines won't create default cluster
+
+    sudo pg_createcluster 9.3 main --start
+
+## Read more
+
+* http://www.postgresql.org/
+* http://www.postgresql.org/docs/9.1/interactive/index.html
+* http://momjian.us/main/writings/pgsql/hw_performance/
+* https://gist.github.com/ibussieres/11262268 - upgrade instructions for ubuntu
\ No newline at end of file