diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4809e39
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+Создал модуль lxc_container в terraform для создания LXC контейнера в proxmox.
+В итоге при выполнении terrafrom создается ВМ с ОС ubuntu из шаблона контейнера (собран шаблон контейнера вручную с внесенными изменениями).
+С настроенной сетью, включенным SSH доступом root.
+
+В основном main.tf подключается сам модуль и указываются переменные.
+В provider.tf указывается плагин провайдера для работы с proxmox - telmate/proxmox и его версия. А также настройки для подключения к proxmox.
+В terraform.tfvars указывается переменная окружения (для прода лучше использовать переменные окружения CI либо vault).
+В variables.tf происходит инициализация переменной окружения.
+
+В modules/lxc_container/main.tf прописывается шаблон создания LXC контейнера ВМ в proxmox.
+В modules/lxc_container/outputs.tf выходные данные, которые нужно передать из модуля в основной файл main.
+В modules/lxc_container/variables.tf происходит инициализация переменных, которые передаются из основного main в модуль.
\ No newline at end of file