diff --git a/README.md b/README.md
index 0f9d3ee..d799b80 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,50 @@
 # ric930-fake-smtp
 
+Fake SMTP сервер для ИВ КонсультантПлюс. Принимает любые соединения с именем пользователя и паролем, сохраняет письма в формате `.eml` с иерархической структурой папок.
+
+## Особенности
+
+- ✅ RFC 5321 (SMTP протокол)
+- ✅ Работа как systemd сервис на Linux и как Windows Service
+
+## Требования
+
+- Go 1.21 или выше
+
+## Сборка из исходников
+
+### 1. Клонирование репозитория
+
+```bash
+https://git.stelm.me/ric930/ric930-fake-smtp/ric930-fake-smtp.git
+cd ric930-fake-smtp
+go mod init ric930-fake-smtp
+go get github.com/kardianos/service
+
+### 2. Сборка бинарников
+```bash
+GOOS=linux GOARCH=amd64 go build -o ric930-fake-smtp
+или
+GOOS=windows GOARCH=amd64 go build -o ric930-fake-smtp.exe
+
+### 3. Запуск и установка в режиме службы
+
+Запуск в интерактивном режиме:
+```bash
+./ric930-fake-smtp или ./ric930-fake-smtp.exe (для Windows)
+
+Установка в качестве systemd юнита:
+```bash
+./ric930-fake-smtp install
+sudo systemctl daemon-reload
+sudo systemctl status ric930-fake-smtp
+sudo systemctl --enable-now ric930-fake-smtp
+sudo journalctl -fu ric930-fake-smtp
+
+Установка в качестве службы в Windows:
+```bash
+./ric930-fake-smtp.exe install
+
+### 4. Файл конфигурации
+config.json находится рядом с бинарным файлом или указывается в параметре --config path/to/config.json
+Секции файла не требуют особых пояснений и интуетивно понятные