diff --git a/grafana/README.md b/grafana/README.md
index 02ec32f..2b0c424 100644
--- a/grafana/README.md
+++ b/grafana/README.md
@@ -1,5 +1,31 @@
 grafana
 =======
 
-`Grafana` is a leading open source application for visualizing large-scale
+![](https://badge.imagelayers.io/vimagick/grafana:latest.svg)
+
+[Grafana][1] is a leading open source application for visualizing large-scale
 measurement data.
+
+## docker-compose.yml
+
+```yaml
+grafana:
+  image: vimagick/grafana
+  ports:
+    - "3000:3000"
+  environment:
+    - GF_SECURITY_ADMIN_USER=admin
+    - GF_SECURITY_ADMIN_PASSWORD=admin
+  restart: always
+```
+
+## up and running
+
+```
+$ docker-compose up -d
+$ docker-compose exec grafana bash
+>>> cd /etc/grafana
+>>> cat grafana.ini
+>>> exit
+$ firefox http://localhost:3000
+```