Ошибка «docker не является внутренней или внешней командой, исполняемой программой или пакетным файлом» появляется в командной строке Windows, когда система не может найти исполняемый файл docker.exe по команде docker. Чаще всего причина в том, что Docker Desktop не установлен, не запущен или путь к его исполняемым файлам отсутствует в переменной окружения PATH.
Сообщение генерирует сам интерпретатор команд cmd.exe или PowerShell: при вводе команды система ищет программу сначала в текущей папке, затем во всех каталогах, перечисленных в PATH. Если ни в одном из них docker.exe не обнаружен, выводится именно эта ошибка. Следовательно, решение сводится к трём направлениям: убедиться, что Docker установлен, проверить его работу и исправить переменные среды.
Ниже разберём каждый сценарий по шагам — от быстрой диагностики до полной переустановки Docker Desktop на Windows 10 и 11.
Быстрая диагностика: что проверить в первую очередь
Прежде чем менять настройки системы, выполните короткую проверку. Откройте Командную строку или PowerShell и введите:
docker --versionЕсли в ответ снова появляется ошибка — Docker либо не установлен, либо недоступен системе. Дополнительно проверьте, запущен ли сам Docker Desktop: найдите его в меню «Пуск» и запустите. Значок кита в области уведомлений (трее) должен перестать «анимироваться» и принять стабильное состояние — это означает, что движок Docker загрузился.
- 🔍 Проверьте наличие Docker Desktop в списке установленных программ:
Параметры → Приложения → Установленные приложения. - 🐳 Убедитесь, что Docker Desktop запущен и значок в трее активен.
- 🔄 Перезапустите терминал после установки — старые окна cmd не видят обновлённый PATH.
- 🖥️ Проверьте, включена ли виртуализация, если Docker Desktop не стартует вообще.
Причина 1: Docker Desktop не установлен
Самая частая ситуация — пользователь скачал дистрибутив, но установка не завершилась, либо Docker вовсе не ставился на данную машину. Проверить это просто: откройте список установленных программ и поищите Docker Desktop. Если его там нет, скачайте установщик с официального сайта docker.com и запустите инсталляцию от имени администратора.
Во время установки мастер может предложить включить компоненты WSL 2 (подсистема Windows для Linux) — соглашайтесь, это рекомендуемый бэкенд для современных версий Docker. После завершения установки система попросит перезагрузку: не пропускайте этот шаг, иначе часть компонентов не зарегистрируется.
⚠️ Внимание: установку Docker Desktop выполняйте только с официального сайта проекта. Сторонние «сборки» и загрузчики с файлообменников могут содержать вредоносный код или устаревшую версию, несовместимую с вашей Windows.
Причина 2: путь к Docker отсутствует в переменной PATH
Если Docker Desktop установлен, но команда не распознаётся, вероятная причина — отсутствие каталога с docker.exe в переменной PATH. Обычно исполняемые файлы находятся в каталоге вида C:\Program Files\Docker\Docker\resources\bin, однако путь может отличаться в зависимости от версии — сверьтесь с фактическим расположением на вашем компьютере через «Проводник».
Чтобы добавить путь вручную, откройте Параметры → Система → О системе → Дополнительные параметры системы → Переменные среды. В списке системных или пользовательских переменных найдите Path, нажмите «Изменить» и добавьте новую строку с путём к каталогу Docker. Сохраните изменения кнопкой «ОК» во всех окнах.
☑️ Как добавить Docker в PATH
После изменения PATH обязательно закройте все открытые окна командной строки и откройте терминал заново — уже запущенные процессы cmd.exe и PowerShell не подхватывают обновлённые переменные среды. Это одна из самых частых причин, почему «ничего не помогло».
Причина 3: Docker Desktop установлен, но не запущен
Даже при корректном PATH команда docker может выдавать ошибки, если движок не работает. Правда, в этом случае сообщение обычно другое — про невозможность подключиться к демону Docker. Но если служба зависла на старте, поведение может быть непредсказуемым, поэтому стоит исключить и этот вариант.
Запустите Docker Desktop из меню «Пуск» и дождитесь полной инициализации: значок в трее перестанет мигать. Если приложение зависает на старте, проверьте, включена ли виртуализация в BIOS/UEFI и работает ли WSL 2 — выполните в PowerShell команду:
wsl --statusЕсли WSL не установлен или устарел, обновите его командой wsl --update и перезагрузите компьютер. Без работающего бэкенда Docker Desktop не сможет запустить движок контейнеров.
Причина 4: повреждённая установка или конфликт версий
Иногда Docker работал, но после обновления Windows, сбоя или ручного удаления файлов установка оказывается повреждена. Признаки: docker.exe физически отсутствует в папке установки, ярлык не запускается, в PATH есть «мёртвые» пути. В таком случае поможет чистая переустановка.
Порядок действий: удалите Docker Desktop через стандартный механизм Windows, перезагрузите компьютер, затем установите свежую версию с официального сайта. Перед удалением убедитесь, что нужные образы и тома вам не критичны, либо сделайте их резервные копии — переустановка может затронуть локальные данные Docker.
| Симптом | Вероятная причина | Действие |
|---|---|---|
| «Не является командой» сразу после установки | Терминал не перезапущен | Закрыть и открыть cmd заново |
| docker.exe отсутствует на диске | Docker не установлен или удалён | Установить Docker Desktop |
| Команда есть, но «cannot connect to the Docker daemon» | Движок не запущен | Запустить Docker Desktop, дождаться загрузки |
| Docker Desktop не стартует | Проблемы с WSL 2 или виртуализацией | Обновить WSL, включить виртуализацию в BIOS |
| Ошибка появилась после обновления | Сбит PATH или повреждена установка | Проверить PATH, переустановить Docker |
Проверка результата
После выполнения любого из шагов откройте новое окно терминала и выполните две команды:
docker --version
docker run hello-world
Первая команда должна вывести номер версии Docker. Вторая скачивает тестовый образ и запускает контейнер — если вы видите приветственное сообщение «Hello from Docker!», значит, и клиент, и движок работают корректно. Если docker --version срабатывает, а docker run выдаёт ошибку подключения, проблема уже не в PATH, а в незапущенном движке.
Что делать, если ничего не помогло
Проверьте, не установлены ли одновременно Docker Desktop и устаревший Docker Toolbox — они конфликтуют. Также посмотрите журнал событий Windows (Просмотр событий → Журналы Windows → Приложение) на предмет ошибок службы Docker. В крайнем случае выполните сброс Docker Desktop через его настройки (раздел Troubleshoot → Reset to factory defaults) — это удалит все образы и контейнеры, но вернёт чистую рабочую конфигурацию.
⚠️ Внимание: сброс Docker Desktop к заводским настройкам безвозвратно удаляет все локальные образы, контейнеры и тома. Перед сбросом экспортируйте важные данные или убедитесь, что образы можно заново загрузить из репозитория.
Ошибка в PowerShell и других терминалах
В PowerShell формулировка отличается: «Имя "docker" не распознано как имя командлета, функции, файла сценария или выполняемой программы». Суть та же — система не находит docker.exe. Все описанные выше шаги применимы и к PowerShell, и к Windows Terminal, и к терминалу в VS Code.
Отдельный нюанс касается VS Code: если редактор был запущен до установки Docker, встроенный терминал унаследует старый PATH. Полностью закройте VS Code (проверьте, что процесс не остался в трее) и запустите заново. То же относится к любым IDE и скриптам, запускаемым из планировщика задач.
Часто задаваемые вопросы
Почему ошибка осталась, хотя я добавил Docker в PATH?
Скорее всего, вы не перезапустили терминал: уже открытые окна cmd и PowerShell используют старые переменные среды. Закройте все окна терминала и откройте новое. Также проверьте, что добавленный путь указывает на реально существующую папку с docker.exe.
Нужно ли перезагружать компьютер после установки Docker Desktop?
Установщик Docker Desktop обычно сам запрашивает перезагрузку, и её лучше выполнить: часть компонентов (включая интеграцию с WSL 2) регистрируется только после перезапуска системы. Без перезагрузки Docker может работать некорректно или не запускаться вовсе.
Можно ли использовать Docker без Docker Desktop на Windows?
Существуют альтернативные варианты — например, запуск Docker внутри дистрибутива WSL 2 или использование сторонних инструментов. Однако для большинства пользователей Docker Desktop остаётся официальным и наиболее простым способом. Учтите, что у Docker Desktop есть условия лицензирования для коммерческого использования в крупных организациях — ознакомьтесь с ними на официальном сайте.
Ошибка появляется только в VS Code, а в обычном cmd всё работает. Что делать?
Полностью закройте VS Code и запустите его снова — редактор наследует переменные среды на момент старта. Если не помогло, перезагрузите компьютер: возможно, VS Code был запущен до установки Docker, и ему нужен свежий системный PATH.
Docker Desktop запускается, но команда docker всё равно не находится. В чём дело?
Проверьте сам файл docker.exe: откройте папку установки Docker Desktop и убедитесь, что исполняемый файл на месте. Если файл отсутствует — установка повреждена, выполните переустановку. Если файл есть, добавьте его каталог в PATH вручную и перезапустите терминал.