diff --git a/charms/garr-dashboard/README.md b/charms/garr-dashboard/README.md
index c65bcf9f0d9e185b8e4913c1bb24ad3d5563b737..ebb538f2a1ad785cd0e0f68e94802b79b223e676 100644
--- a/charms/garr-dashboard/README.md
+++ b/charms/garr-dashboard/README.md
@@ -1,38 +1,36 @@
 # Overview
 
-Subordinate charm to the Horizon Dashboard.
-It installs the Dashboard theme and the accountimg plugin.
+Subordinate charm to the `Horizon Dashboard`.
+It installs the dashboard accountimg plugin.
 
-## Installation
+# Usage
 
-#. Download the charm to a local folder (garr-dashboard)::
+#. Download the charm to a local folder::
 
-   $ wget https://git.garr.it/cloud/GUI/dashboard/-/archive/master/dashboard-master.tar.gz
-   
+   $ wget https://git.garr.it/cloud/GUI/dashboard/-/archive/master/dashboard-master.tar.gz?path=charms%2Fgarr-dashboard
+   $ tar zxf dashboard-master-charms-garr-dashboard/charms/garr-dashboard
 
 #. deploy the charm::
 
-    $ juju deploy ./garr-dashboard
+    $ juju deploy ./dashboard-master-charms-garr-dashboard/charms/garr-dashboard
     
-#. configure the charm for database connection::
+#. configure the connection to the accounting database:
 
     $ 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::
+#. add relations to the Horizon dashboard main charm:
 
-    $ juju add-relation dashboard-cloudbase garr-dashboard
+    $ juju add-relation openstack-dashboard garr-dashboard
 
-#. add relations to the identity service::
+#. add relations to the identity service:
 
     $ juju add-relation dashboard-cloudbase keystone:identity-service
     
-#. Optional: set the deault gateway:
+#. Optional: set the default gateway:
 
     $ juju deploy cs:~csd-garr/defaultgw
     $ juju add-relation dashboard-cloudbase defaultgw
 
-