diff --git a/README.md b/README.md
index 6637810..6d66f22 100644
--- a/README.md
+++ b/README.md
@@ -358,7 +358,39 @@ def get_value(key):
 
 ## Lua-скрипты
 
+> [!CAUTION]
+> **Поддержка работы lua в настоящий момент эксперементальная и может вызвать аварийное завершение сервера!!!**
 
+1. Интерактивный режим работы, (выполнение скрипта в клиенте `futriix-cli`):
+
+```sh
+  futriix:~> futexec
+lua> return "Hello, " .. os.date("%Y-%m-%d")
+```
+
+2. Выполнение файлов скриптов (c помоью команды в клиенте `SysExec`):
+
+    ```sh
+    futriix:~> sysexec my_script
+
+   ````
+
+3. Доступ к данным из сервера Lua
+
+Скрипты имеют доступ к специальному API:
+
+```sh
+-- Чтение данных
+local value = futriix.get("my_key")
+
+-- Запись данных
+futriix.put("temp_key", {data = "test", ts = os.time()})
+
+-- Пример сложной логики
+for i = 1, 10 do
+    futriix.put("counter/"..i, i*2)
+end
+```
 
 <p align="right">(<a href="#readme-top">К началу</a>)</p>