Ollama не запускается или не работает: разбор ошибок по тексту
Что делать, если Ollama не запускается на Windows, macOS или Linux: could not connect to ollama app, порт 11434 занят, «ollama не является внутренней или внешней командой», model requires more system memory, pull model manifest: file does not exist. Где лежат логи и как проверить сервер.
Ollama — это две части: сервер, который держит модели в памяти и слушает порт 11434, и
команда ollama, которая к этому серверу обращается. Почти любое «не запускается» — это
одна из них не стартовала или не видит другую. Ниже ошибки сгруппированы по тексту, который
ты видишь, с причиной и исправлением.
Сначала проверь, жив ли сервер
curl http://127.0.0.1:11434
Ответ Ollama is running значит, что сервер работает и проблема в клиенте или модели. Если
соединение не устанавливается, сервер не запущен. На Windows в браузере можно просто открыть
http://127.0.0.1:11434.
Ошибки по тексту
could not connect to ollama app, is it running?
Error: could not connect to ollama app, is it running?
Команда ollama есть, а сервер не запущен.
- Windows и macOS: запусти приложение Ollama из меню «Пуск» или Launchpad. Оно работает в фоне, значок появляется в трее или строке меню. Окно может не открыться, это нормально.
- Linux:
sudo systemctl start ollama, проверить —systemctl status ollama. - Или вручную в отдельном окне терминала:
ollama serve. Это окно закрывать нельзя.
Если ты менял OLLAMA_HOST, клиент ищет сервер по новому адресу. Значение переменной должно
быть одинаковым там, где запускается сервер, и там, где ты вводишь команды.
bind: Only one usage of each socket address
Error: listen tcp 127.0.0.1:11434: bind: Only one usage of each socket address
(protocol/network address/port) is normally permitted.
На Linux и macOS тот же случай звучит как address already in use. Порт 11434 уже занят, чаще
всего самой Ollama: приложение в трее уже держит сервер, а ты запускаешь ollama serve
второй раз. Ничего чинить не нужно, просто пользуйся командами.
Если Ollama точно закрыта, найди, кто занял порт:
netstat -ano | findstr 11434
Последнее число в строке — PID процесса, его имя покажет tasklist /FI "PID eq 1234". Можно
запустить Ollama на другом порту: OLLAMA_HOST=127.0.0.1:11500. Но тогда и всем клиентам
нужно указать этот адрес.
«ollama» не является внутренней или внешней командой
"ollama" не является внутренней или внешней командой, исполняемой программой или пакетным файлом.
Установщик кладёт программу в %LOCALAPPDATA%\Programs\Ollama и добавляет эту папку в PATH
пользователя. Новый PATH видят только новые окна терминала. Закрой терминал и VS Code и
открой заново. Если не помогло, проверь, что ollama.exe в этой папке есть, и добавь её в
PATH вручную.
model requires more system memory
Error: model requires more system memory (12.4 GiB) than is available (9.8 GiB)
Модель не помещается в свободную оперативную память. Возьми модель меньше или квантизацию
легче (q4_K_M вместо q8_0), закрой браузер и другие тяжёлые программы. Если включена
длинная история контекста, уменьши num_ctx. Кэш контекста тоже занимает память.
pull model manifest: file does not exist
Error: pull model manifest: file does not exist
Такого имени или тега нет в библиотеке Ollama. Проверь точное написание на ollama.com/library:
тег пишется через двоеточие (qwen3:8b, а не qwen3-8b). Для моделей с Hugging Face нужен
полный путь вида hf.co/автор/репозиторий:Q4_K_M.
Модель скачивается и обрывается
Ollama докачивает с места обрыва. Просто повтори ollama pull. Если обрывы постоянные, проверь
свободное место: на Windows модели лежат в C:\Users\<имя>\.ollama\models, а файлы весят от
двух до нескольких десятков гигабайт. Перенести папку на другой диск можно переменной
OLLAMA_MODELS.
Не открывается окно на Windows
Ollama на Windows живёт в трее. Если иконка уже есть, повторный запуск ничего не покажет. Если иконки нет и процесс сразу пропадает:
- Проверь версию системы: нужна Windows 10 22H2 или новее.
- Посмотри лог: Win+R →
%LOCALAPPDATA%\Ollama→server.log. - Антивирус иногда блокирует запуск сервера или распаковку библиотек во временную папку.
Если в логе ошибки доступа к
%TEMP%\ollama*, добавь папку Ollama в исключения. - Подробный лог: закрой Ollama в трее, в PowerShell выполни
$env:OLLAMA_DEBUG="1"и запусти& "ollama app.exe".
Где логи
| Система | Где смотреть |
|---|---|
| Windows | %LOCALAPPDATA%\Ollama\server.log |
| macOS | ~/.ollama/logs/server.log |
| Linux (systemd) | journalctl -u ollama --no-pager |
| Docker | docker logs <имя контейнера> |
Если сервер запустился, а модель работает медленно, скорее всего она считается на процессоре. Это разобрано в статье Ollama не использует GPU.
Без отдельного сервера
Ollama нужна, когда модель работает как сервис для нескольких программ. Если цель — агент,
который читает файлы и выполняет задачи, лишний слой можно убрать. В Доке
локальная модель скачивается и запускается внутри приложения, подобранная под твоё железо,
без порта, PATH и переменных окружения. Если Ollama уже настроена, Дока подключится и к ней,
а заодно поможет с ошибками выше: агент прочитает server.log и проверит порт сам, показав
каждую команду перед запуском.