Compose не запускается: проверьте конфигурацию до старта

Если docker compose up останавливается на ошибке конфигурации, сначала отдельно проверьте Compose-файл. Памятка для Windows, macOS и Linux с уже установленным Docker Compose v2; установка, аккаунт и подключение ИИ здесь не нужны. Проверено по документации 17.10.2026, без запуска на машине читателя.

Одна проверка

1. Откройте каталог своего доверенного проекта. Если используется нестандартный файл, укажите его явно: docker compose -f compose.yaml config --quiet, заменив имя на своё.
2. Для обычного проекта выполните docker compose config --quiet. Ключ --quiet оставляет проверку конфигурации без печати всего итогового YAML. При успешной проверке вывода конфигурации не будет; ошибки и предупреждения требуют отдельного внимания.
3. Если проверка сообщает проблему, проверьте указанные файл и строку, отступы YAML и подстановки переменных. Исправьте только понятную причину и повторите проверку.

Эта команда не запускает сервисы и не доказывает, что образ скачивается, порт свободен или приложение работает. Обычный config разворачивает переменные в итоговой модели, поэтому не публикуйте его полный вывод: там могут оказаться чувствительные значения. Даже сообщение об ошибке перед отправкой обезличьте.

Проверка сама не меняет Compose-файл — откат для неё не нужен. Перед ручной правкой сохраните свою копию; при неудаче верните только эту правку. Если команда Compose не найдена, сначала проверьте установленный инструмент, а не исправляйте YAML наугад.

Вопрос для обсуждения: на чём у вас чаще останавливается Compose — отступы YAML, переменные окружения или уже запуск приложения после успешной проверки? Можно ответить одним вариантом и коротким обезличенным примером.

Проверяемые источники

• Docker Docs: docker compose config