diff --git a/files/bifrost/docker-compose.template.yml b/files/bifrost/docker-compose.template.yml
index dd32dc8..afd8103 100644
--- a/files/bifrost/docker-compose.template.yml
+++ b/files/bifrost/docker-compose.template.yml
@@ -3,6 +3,10 @@
 # Клиенты ходят в него по имени bifrost_app:8080 в общей web_proxy_network и про
 # провайдера/модель ничего не знают — роутинг решает config.json.
 # See versions: https://hub.docker.com/r/maximhq/bifrost/tags
+# Тег образа = GitHub-релиз transports/vX.Y.Z (там же changelog и миграции БД);
+# теги 2.1.x в том же списке — это helm-chart, не образ. Конфиг после апдейта
+# валидировать по transports/config.schema.json из нужного тега: Bifrost на Go
+# молча игнорирует ключ, положенный не в ту секцию, в логах этого не видно.
 #
 # В контейнере Bifrost слушает 8080 (дефолт). Наружу host-порт НЕ пробрасываем:
 # веб-UI (Dashboard + Logs) и API доступны только через Caddy