diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e7b3dcf
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# Yeelight to MQTT bridge
+
+Works with Yeelight WiFi bulbs (color and monochrome).
+Sample docker-compose.yml file:
+`yeelight:
+  build: .
+  container_name: yeelight
+  environment:
+    - MQTT_SERVER=192.168.1.93
+    - MQTT_USER=mqtt_user
+    - MQTT_PASS=passw0rd
+  restart: always`
+
+`docker-compose build && docker-compose up -d`
+
+You need to edit you bulb IPs in main.py (not yet fixed).
+
+## Known bugs:
+- Lamp's alive status updated only at startup.
+- IP-Name list in main.py
+- Bad code style =(
\ No newline at end of file