diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9311c39
--- /dev/null
+++ b/README.md
@@ -0,0 +1,57 @@
+![logo](/assets/logo.svg)
+
+## Features
+- Hot water temperature control
+- Heating temperature control
+- Smart heating temperature control modes:
+   - PID
+   - Equithermic curves - adjusts the temperature based on indoor and outdoor temperatures
+- Hysteresis setting (for accurate maintenance of room temperature)
+- Ability to connect an external sensor to monitor outdoor temperature (DS18B20)
+- Diagnostics:
+  - The process of heating the coolant for heating: works / does not work
+  - The process of heating water for hot water: working / not working
+  - Display of boiler errors
+  - Burner status: on/off
+  - Burner modulation level in percent
+  - Pressure in the heating system
+  - Gateway status (depending on errors and connection status)
+  - Boiler connection status via OpenTherm interface
+  - The current temperature of the heat carrier (usually the return heat carrier)
+  - Set coolant temperature (depending on the selected mode)
+  - Current hot water temperature
+- Auto tuning of PID and Equitherm parameters *(in development)*
+- [Home Assistant](https://www.home-assistant.io/) integration via MQTT. The ability to create any automation for the boiler!
+
+## Compatible Open Therm Adapters
+- [Ihor Melnyk OpenTherm Adapter](http://ihormelnyk.com/opentherm_adapter)
+- [OpenTherm master shield for Wemos/Lolin](https://www.tindie.com/products/thehognl/opentherm-master-shield-for-wemoslolin/)
+- And others. It's just that the adapter must implement [the schema](http://ihormelnyk.com/Content/Pages/opentherm_adapter/opentherm_adapter_schematic_o.png)
+
+# Quick Start
+## Dependencies
+- [ArduinoJson](https://github.com/bblanchon/ArduinoJson)
+- [TelnetStream](https://github.com/jandrassy/TelnetStream)
+- [EEManager](https://github.com/GyverLibs/EEManager)
+- [ESP8266Scheduler](https://github.com/nrwiersma/ESP8266Scheduler)
+- [NTPClient](https://github.com/arduino-libraries/NTPClient)
+- [PubSubClient](https://github.com/knolleary/pubsubclient)
+- [GyverFilters](https://github.com/GyverLibs/GyverFilters)
+- [MultiMap](https://github.com/RobTillaart/MultiMap)
+- [WiFiManager](https://github.com/tzapu/WiFiManager)
+
+
+## Settings
+1. Connect to *OpenTherm Gateway* hotspot
+2. Open configuration page in browser: 192.168.4.1
+3. Set up a connection to your wifi network
+4. Set up a connection to your MQTT server
+
+After connecting to your wifi network, you can go to the setup page at the address that esp8266 received.
+The OTGateway device will be automatically added to homeassistant if MQTT server ip, login and password are correct.
+
+## HomeAsssistant settings
+
+## Debug
+To display DEBUG messages you must enable debug in settings (switch is disabled by default).
+You can connect via Telnet to read messages. IP: esp8266 ip, port: 23