diff --git a/README.rst b/README.rst
index c0a097a535d60ffe4874c262bfeac3af056c97fd..fb215e3ce51e3c734891a5998d088c5936919043 100644
--- a/README.rst
+++ b/README.rst
@@ -6,11 +6,16 @@ A diaspora authenticator for matrix synapse.
 Installation
 ------------
 
-This package is not submitted to pypi yet, so you would have to make do
-with the repo.
+This package is easy to install from pypi:
 
 Just run this command to install:
 
+.. code:: bash
+
+    pip install synapse-diaspora-auth
+
+Alternatively, to install from git:
+
 .. code:: bash
 
     pip install git+https://git.fosscommunity.in/necessary129/synapse-diaspora-auth.git
@@ -28,33 +33,62 @@ should look like this:
         config:
           pepper: <pepper>
           database:
-            name: "diaspora_production"
+            engine: <db engine>
+            name: "<database>"
             username: <db_user>
             password: <db_password>
             host: "127.0.0.1"
-            port: 5432
+            port: <port>
 
 You should get ``pepper`` from ``<DIASPORA_HOME>/database.yaml`` or from
 ``<DIASPORA_HOME>/initializers/devise.rb`` as ``config.pepper``.
 
+the engine should either be ``mysql`` or ``postgres``
+
+The port is usually ``5432`` for PostgreSQL and ``3306`` for MariaDB/MySQL
+
 Database
 ~~~~~~~~
 
+synapse-diaspora-auth currently supports MySQL and PostgreSQL as the database engines.
+
+PostgreSQL
+^^^^^^^^^^
+
 It is recommended to create a seperate user for synapse in the postgres
-database, with read-only access to ``diaspora_production``.
+database, with read-only access to ``<database>``.
 
 To do that, first login to postgres as the root user:
 
 .. code:: bash
 
-    sudo -u postgres psql diaspora_production
+    sudo -u postgres psql <database>
 
 then, run these commands:
 
 .. code:: sql
 
     CREATE user <db_user> WITH password '<db_password>';
-    GRANT CONNECT ON DATABASE diaspora_production TO <db_user>;
+    GRANT CONNECT ON DATABASE <database> TO <db_user>;
     GRANT SELECT ON users TO <db_user>;
 
+MySQL
+^^^^^
+
+The commands are almost the same in MySQL:
+
+login to MySQL as root:
+
+.. code:: bash
+
+    sudo mysql -u root
+
+Then run these queries:
+
+.. code:: sql
+
+    CREATE user '<db_user>'@'localhost' WITH password '<db_password>';
+    GRANT SELECT ON <database>.users TO '<db_user>'@'localhost';
+
+
 And you will be good to go!
\ No newline at end of file