К содержимому

Docker Compose up не запускается: ошибки и способы их устранения

Если docker compose up завершается ошибкой или контейнеры сразу останавливаются, сначала посмотрите вывод команды и логи проблемного сервиса. Чаще всего причина в занятом порте, отсутствующем образе, неверном синтаксисе YAML или нехватке прав.

Ошибка Docker 3 мин чтения

01Синтаксическая ошибка в docker-compose.yml

Compose не запускается, если в файле docker-compose.yml есть опечатка: неправильный отступ, пропущенное двоеточие или неверный тип значения. Проверьте конфигурацию командой docker compose config. Она покажет место ошибки с номером строки. Исправьте YAML и повторите запуск.

bash
docker compose config

02Занят порт, указанный в ports

Ошибка Bind for 0.0.0.0:80 failed: port is already allocated означает, что порт уже слушает другой процесс. Проверьте, кто занимает порт: sudo ss -tlnp | grep :80. Остановите конфликтующий сервис или измените публикуемый порт в docker-compose.yml, например на 8080:80.

bash
sudo ss -tlnp | grep :80

03Образ не найден или не собирается

Если в логах pull access denied или manifest unknown, проверьте имя образа и тег в docker-compose.yml. Для сервисов с build убедитесь, что Dockerfile существует и сборка проходит без ошибок. Запустите docker compose build и посмотрите вывод. Для готовых образов выполните docker compose pull.

bash
docker compose pull

04Контейнер запускается и сразу завершается

Когда docker compose up -d показывает Exit 1, смотрите логи сервиса: docker compose logs -f app. Причина может быть в неверной команде command, отсутствующем файле конфигурации или ошибке подключения к базе. Исправьте команду или смонтируйте нужные файлы через volumes.

bash
docker compose logs -f app

05Нет прав на docker.sock

Ошибка permission denied while trying to connect to the Docker daemon socket появляется, если пользователь не входит в группу docker. Добавьте его: sudo usermod -aG docker $USER, затем перезайдите в сессию. Проверьте права на /var/run/docker.sock.

bash
sudo usermod -aG docker $USER

06Как убедиться, что ошибка устранена

После исправлений выполните docker compose up -d и проверьте статус: docker compose ps. Все сервисы должны быть в состоянии running или healthy. Если контейнер перезапускается, снова посмотрите логи. Для полной остановки и удаления контейнеров используйте docker compose down.

bash
docker compose up -d
docker compose ps

Что не помогает

  • Перезапускать Docker без анализа логов.

    Сначала посмотрите docker compose logs app и docker compose config, чтобы найти конкретную ошибку.

  • Менять порт в ports без проверки занятости.

    Проверьте порт командой sudo ss -tlnp | grep :НОМЕР и выберите свободный.

  • Удалять все контейнеры и тома командой docker system prune -a --volumes.

    Это удалит данные. Используйте docker compose down без флага -v, если нужно сохранить тома.

Deploykin

Как это делается в Deploykin

В Deploykin Docker-контейнеры создаются, запускаются и останавливаются из панели. Там же видны их статусы и тома, терминал для этого не нужен.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Почему docker compose up пишет port is already allocated?

Порт уже занят другим процессом или контейнером. Проверьте sudo ss -tlnp | grep :80 и освободите порт или измените映射 в docker-compose.yml.

Как посмотреть логи контейнера, который не запускается?

Выполните docker compose logs -f имя_сервиса. Если контейнер сразу завершается, логи покажут причину остановки.

Что делать, если docker compose config выдаёт ошибку?

Исправьте YAML в указанной строке: проверьте отступы, двоеточия и кавычки. После правки снова запустите docker compose config.

Почему docker compose up требует sudo?

Пользователь не входит в группу docker. Добавьте его командой sudo usermod -aG docker $USER и перезайдите.

Ещё по теме

Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.