diff --git a/README.md b/README.md
new file mode 100644
index 0000000..be3988b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,48 @@
+# Мониторинг AmneziaWG в Zabbix
+
+Красивый и структурированный шаблон для мониторинга **AmneziaWG** с возможностью автообнаружения (LLD) туннелей.
+
+## Инструкция по установке
+
+### Шаг 1. Импорт шаблона
+1. Перейдите в веб-интерфейс Zabbix: **Data collection** → **Templates** (Сбор данных → Шаблоны).
+2. Нажмите кнопку **Import** (Импорт) в правом верхнем углу.
+3. Выберите файл шаблона `zbx_export_templates.yaml` (или `.xml`) и подтвердите импорт.
+
+### Шаг 2. Размещение скриптов на сервере AmneziaWG
+Перенесите скрипты мониторинга на целевой сервер в директорию `/etc/zabbix/`:
+* `/etc/zabbix/amnezia_zabbix.sh` — основной bash-скрипт для работы с агентом.
+* `/etc/zabbix/amnezia_stats.py` — python-скрипт для парсинга метрик AmneziaWG.
+
+### Шаг 3. Настройка прав доступа
+Сделайте bash-скрипт исполняемым, выполнив команду в терминале сервера:
+```bash
+sudo chmod +x /etc/zabbix/amnezia_zabbix.sh
+```
+
+### Шаг 4. Настройка Zabbix-агента
+Добавьте в конфигурационный файл агента (обычно `/etc/zabbix/zabbix_agent2.conf` или отдельный файл в `/etc/zabbix/zabbix_agent2.d/`) следующие параметры **UserParameter**:
+
+```ini
+UserParameter=amnezia.discovery,/etc/zabbix/amnezia_zabbix.sh discovery
+UserParameter=amnezia.rx[*],/etc/zabbix/amnezia_zabbix.sh rx $1
+UserParameter=amnezia.tx[*],/etc/zabbix/amnezia_zabbix.sh tx $1
+UserParameter=amnezia.handshake[*],/etc/zabbix/amnezia_zabbix.sh handshake $1
+```
+
+### Шаг 5. Перезапуск службы агента
+Примените изменения, перезапустив Zabbix-агент:
+```bash
+systemctl restart zabbix-agent2
+```
+
+### Шаг 6. Привязка шаблона
+1. В интерфейсе Zabbix откройте настройки нужного узла сети (**Hosts**).
+2. Вкладка **Templates** → начните вводить имя импортированного шаблона и выберите его.
+3. Нажмите **Update** (Обновить).
+
+---
+
+## Использование и метрики
+Для вывода информации на дашборды или создания кастомных графиков используйте ключевой элемент данных:
+* **`AmneziaWG: Connected users`** — отображает текущее количество активных пользователей в сети.