diff --git a/readme.md b/readme.md
index 966a04c..879b36b 100644
--- a/readme.md
+++ b/readme.md
@@ -7,6 +7,7 @@ Demo приложение для изучения языка `kotlin` и фре
 * `jdk` версии `17`
 * `postgresql` версии `14`
 * `kafka` без авторизации
+* `grafana-agent` (или аналогичный otlp-совместимый сборщик трейс-логов)
 * `docker` + `compose`
 
 ## Доступные команды
@@ -16,6 +17,8 @@ Demo приложение для изучения языка `kotlin` и фре
     ./gradlew test
     ```
   
+    * после прохождения тестов можно увидеть [карту покрытия](/build/reports/jacoco/test/html/index.html).
+  
 * запуск приложения
     ```shell
     ./gradlew bootRun
@@ -23,6 +26,11 @@ Demo приложение для изучения языка `kotlin` и фре
 
 ## Запуск с docker-compose
 
+Перед первым запуском необходимо:
+* запустить отдельно контейнеры с postgres, kafka и grafana-agent (опционально)
+* убедиться, что все запущенные контейнеры будут видеть контейнер с приложением (например, добавить везде сеть `spring-boot-demo_default`)
+* скопировать [.env.example](/.env.example) в [.env](/.env) и изменить конфигурацию
+
 Перед каждым запуском необходимо собрать приложение:
 ```shell
 ./gradlew assemble
@@ -30,5 +38,5 @@ Demo приложение для изучения языка `kotlin` и фре
 
 Затем можно запускать контейнер:
 ```shell
-docker compose up -d
+docker compose up
 ```
\ No newline at end of file