Docker Compose up не запускается: ошибки и способы их устранения
Если docker compose up завершается ошибкой или контейнеры сразу останавливаются, сначала посмотрите вывод команды и логи проблемного сервиса. Чаще всего причина в занятом порте, отсутствующем образе, неверном синтаксисе YAML или нехватке прав.
01Синтаксическая ошибка в docker-compose.yml
Compose не запускается, если в файле docker-compose.yml есть опечатка: неправильный отступ, пропущенное двоеточие или неверный тип значения. Проверьте конфигурацию командой docker compose config. Она покажет место ошибки с номером строки. Исправьте YAML и повторите запуск.
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.
sudo ss -tlnp | grep :80
03Образ не найден или не собирается
Если в логах pull access denied или manifest unknown, проверьте имя образа и тег в docker-compose.yml. Для сервисов с build убедитесь, что Dockerfile существует и сборка проходит без ошибок. Запустите docker compose build и посмотрите вывод. Для готовых образов выполните docker compose pull.
docker compose pull
04Контейнер запускается и сразу завершается
Когда docker compose up -d показывает Exit 1, смотрите логи сервиса: docker compose logs -f app. Причина может быть в неверной команде command, отсутствующем файле конфигурации или ошибке подключения к базе. Исправьте команду или смонтируйте нужные файлы через volumes.
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.
sudo usermod -aG docker $USER
06Как убедиться, что ошибка устранена
После исправлений выполните docker compose up -d и проверьте статус: docker compose ps. Все сервисы должны быть в состоянии running или healthy. Если контейнер перезапускается, снова посмотрите логи. Для полной остановки и удаления контейнеров используйте docker compose down.
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 Ошибка error response from daemon docker: причины и исправление Разбираем ошибки Docker и Docker Compose: занятый порт, permission denied на docker.sock, YAML, права на каталог. Команды проверки и исправления.
- Ошибка · Docker Ошибка docker compose command not found: почему команда не найдена и как исправить Почему Ubuntu 24.04 не видит команду docker compose: проверка плагина, установка docker-compose-plugin, PATH и переход со старого docker-compose v1.
- Ошибка · Docker Ошибка permission denied при монтировании volume в Docker Compose Разбираем ошибку permission denied при монтировании volume в Docker Compose: проверка прав, настройка пользователя в контейнере, команды для исправления.
- Руководство · Docker docker images: работа с образами Docker на Ubuntu 24.04 Как работать с docker images на Ubuntu 24.04: проверить демон, скачать образ через docker pull, посмотреть список, запустить контейнер и проверить результат.
- Руководство · Docker Установка Docker и Docker Compose на Ubuntu 24.04 Пошаговая установка Docker и Docker Compose на Ubuntu 24.04: команды, настройка compose.yaml, проверка работы и разбор частых ошибок.
- Руководство · Docker Как запустить Docker container на Ubuntu 24.04: пошаговая инструкция Запустите контейнер через docker compose up -d, проверьте статус, посмотрите логи, войдите в контейнер через exec и остановите проект. Команды и проверка.
Docker Compose: руководство по работе с многоконтейнерными приложениями: все материалы темы