diff --git a/hass/README.md b/hass/README.md
index 6664306..14392f4 100644
--- a/hass/README.md
+++ b/hass/README.md
@@ -1,8 +1,28 @@
 home-assistant
 ==============
 
+![](https://home-assistant.io/demo/favicon-192x192.png)
+
+[Home Assistant][1] is an open-source home automation platform running on
+Python 3. Track and control all devices at home and automate control. Perfect
+to run on a Raspberry Pi.
+
+## directory tree
+
+```
+~/fig/hass/
+├── data/
+│   ├── configuration.yaml
+│   ├── device_trackers.yaml
+│   ├── groups.yaml
+│   └── known_devices.yaml
+└── docker-compose.yml
+```
+
 ## docker-compose.yml
 
+Lightweight without bluetooth [trackers][2]
+
 ```yaml
 hass:
   image: vimagick/hass
@@ -12,6 +32,18 @@ hass:
   restart: unless-stopped
 ```
 
+Heavyweight with bluetooth [trackers][2]
+
+```yaml
+hass:
+  image: vimagick/hass:debian
+  volumes:
+    - ./data:/etc/hass
+  net: host
+  privileged: yes
+  restart: unless-stopped
+```
+
 ## up and running
 
 ```bash
@@ -20,5 +52,81 @@ $ docker-compose logs -f
 $ curl http://localhost:8123
 ```
 
-> More python packages will be installed during startup.
-> The missing package can be installed: `pip install --target=data sqlalchemy==1.1.3`.
+```bash
+# Error during Bluetooth LE scan: Invalid device!
+$ sudo hciconfig hci0 down
+$ sudo hciconfig hci0 up
+```
+
+> More python packages will be installed during startup automatically.
+
+## quick start
+
+```yaml
+# configuration.yaml
+group: !include groups.yaml
+device_tracker: !include device_trackers.yaml
+```
+
+```yaml
+default_view:
+  view: yes
+  entities:
+    - group.living_room
+    - group.bedroom
+
+Living Room:
+  view: no
+  entities:
+    - device_tracker.band
+    - device_tracker.iphone
+
+Bedroom:
+  view: no
+  entities:
+    - device_tracker.android
+```
+
+```yaml
+# device_trackers.yaml
+- platform: bluetooth_le_tracker
+  interval_seconds: 30
+  consider_home: 120
+  track_new_devices: no
+- platform: ubus
+  host: 192.168.1.1
+  username: root
+  password: ********
+  track_new_devices: no
+```
+
+```yaml
+# known_devices.yaml
+mi_band_2:
+  hide_if_away: false
+  mac: BLE_D7:3D:97:88:88:88
+  name: Band
+  gravatar: vimagick@gmail.com
+  picture:
+  track: true
+  vendor: unknown
+
+kevin_iphone:
+  hide_if_away: false
+  mac: 48:A1:95:88:88:88
+  name: iPhone
+  picture: https://upload.wikimedia.org/wikipedia/commons/thumb/f/fa/Apple_logo_black.svg/80px-Apple_logo_black.svg.png
+  track: true
+  vendor: Apple, Inc.
+
+kevin_android:
+  hide_if_away: false
+  mac: 8C:70:5A:88:88:88
+  name: Android
+  picture: https://upload.wikimedia.org/wikipedia/commons/thumb/d/db/Android_robot_2014.svg/75px-Android_robot_2014.svg.png
+  track: true
+  vendor: unknown
+```
+
+[1]: https://home-assistant.io/
+[2]: https://home-assistant.io/components/device_tracker/