diff --git a/charms/garr-dashboard/README.md b/charms/garr-dashboard/README.md
index 0f22fa6bfce9d97822bd78f4aa7d49b601feb37b..35c49c44c9e6931978baeb3b4ba129e875540b60 100644
--- a/charms/garr-dashboard/README.md
+++ b/charms/garr-dashboard/README.md
@@ -1,3 +1,37 @@
 # Overview
 
-Installs the Garr Dashboard theme and plugins
+Subordinate charm to the Horizon Dashboard.
+It installs the Dashboard theme and the accountimg plugin.
+
+## Installation
+
+#. Download the charm to a local folder (garr-dashboard)::
+
+   $ git clone
+
+#. deploy the charm::
+
+    $ juju deploy ./garr-dashboard
+    
+#. configure the charm for database connection::
+
+    $ juju config garr-dashboard database-host=<DB_HOST>
+    $ juju config garr-dashboard database-name=<DB_NAME>
+    $ juju config garr-dashboard database-user=<DB_USER>
+    $ juju config database-user-password=<DB_PASS:
+    $ juju config horizon-webroot=/
+
+#. add relations to the Horizon dashboard main charm::
+
+    $ juju add-relation dashboard-cloudbase garr-dashboard
+
+#. add relations to the identity service::
+
+    $ juju add-relation dashboard-cloudbase keystone:identity-service
+    
+#. Optional: set the deault gateway:
+
+    $ juju deploy cs:~csd-garr/defaultgw
+    $ juju add-relation dashboard-cloudbase defaultgw
+
+