Как установить и запустить Ollama

После выполнения этой инструкции у вас будет установлен Ollama и запущен локальный экземпляр, который отвечает по адресу http://localhost:11434/api. Проверить результат можно без загрузки модели: через ollama -v и запрос curl http://localhost:11434/api/tags.

Практический вердикт: если вам нужен самый прямой локальный запуск, ставьте нативную версию для своей ОС и проверяйте работу через ollama -v и curl http://localhost:11434/api/tags. Docker имеет смысл, если вы хотите контейнерный сценарий и отдельный том для данных моделей.

Редакционное ограничение: в этом материале не фиксируются прямые URL конкретных инсталляторов и не разбирается полная настройка GPU-драйверов. В исходном пакете для публикации эти детали собраны не полностью, поэтому перед развёртыванием перепроверьте текущие ссылки загрузки и аппаратные требования на официальных страницах.

Пошаговая установка и запуск

1. Выберите один сценарий установки.

   Не выполняйте все варианты подряд. Для обычного локального компьютера выберите нативную установку на macOS, Windows или Linux. Если вам нужен контейнер, переходите сразу к шагу с Docker.

   Ожидаемый результат: вы понимаете, какой путь установки подходит вашей системе и не смешиваете нативный и контейнерный сценарии.

2. Установите Ollama на macOS.

   На официальной странице macOS используйте актуальную загрузку, затем смонтируйте ollama.dmg и перетащите Ollama в Applications. В документации указано минимальное требование: macOS Sonoma 14+, поддерживаются Apple Silicon и Intel x86.

   Ожидаемый результат: приложение Ollama появляется в Applications, а система соответствует требованиям из официальной страницы.

3. Установите Ollama на Windows.

   Запустите OllamaSetup.exe. Официальная документация указывает, что установка работает без прав Administrator, ставится в профиль пользователя по умолчанию и требует Windows 10 22H2 или новее.

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

4. Установите Ollama на Linux.

   Выполните официальный установочный сценарий:

   curl -fsSL https://ollama.com/install.sh | sh

   После завершения сразу проверьте бинарник документированной командой:

   ollama -v

   Ожидаемый результат: команда ollama -v возвращает установленную версию, а не ошибку о неизвестной команде.

5. Запустите Ollama локально.

   В официальном quickstart рекомендуют открыть терминал и запустить ollama. Это открывает интерактивное меню. Если вы на Linux и хотите явно поднять локальный сервер, используйте документированную команду:

   ollama serve

   Если вы используете системный сервис на Linux, документированные команды проверки такие:

   systemctl status ollama
   journalctl -e -u ollama

   Ожидаемый результат: команда запуска выполняется без ошибки, а в Linux-сценарии сервер или сервис остаётся доступным для локальных запросов.

6. Проверьте локальный API.

   По умолчанию Ollama обслуживает локальный API по адресу http://localhost:11434/api. Выполните документированный запрос проверки:

   curl http://localhost:11434/api/tags

   Ожидаемый результат: вы получаете ответ от сервера со списком локальных моделей. Даже если список пуст, сам ответ подтверждает, что API поднят и отвечает.

7. Используйте Docker вместо нативной установки, если нужен контейнер.

   Официальная команда быстрого старта для контейнера:

   docker run -d -v ollama:/root/.ollama -p 11434:11434 --name ollama ollama/ollama

   Для NVIDIA GPU документация требует NVIDIA Container Toolkit и параметр --gpus=all. Если GPU вам не нужен, оставьте базовую команду без дополнительных флагов.

   Ожидаемый результат: контейнер стартует, а локальный API доступен на том же порту 11434.

Как проверить, что всё работает

1. Проверьте наличие CLI.

   Выполните ollama -v. Для корректной установки команда должна вернуть версию, а не ошибку оболочки.

2. Проверьте локальный API.

   Выполните curl http://localhost:11434/api/tags. Исправный сервер отвечает JSON-данными со списком локальных моделей.

3. Проверьте Linux-сервис, если используете именно его.

   Выполните systemctl status ollama и, если нужно, journalctl -e -u ollama. Это документированные способы понять, жив ли сервис и что именно произошло при запуске.

Минимальный признак успеха для любой ОС один: у вас есть работающая команда ollama и отвечающий локальный адрес http://localhost:11434/api.

Частые ошибки и исправления

• ❌ Ошибка: ollama -v не возвращает версию.

  ✅ Решение: установка не завершилась или выбран не тот сценарий. Повторите официальный путь для вашей ОС: ollama.dmg на macOS, OllamaSetup.exe на Windows или curl -fsSL https://ollama.com/install.sh | sh на Linux, затем снова проверьте ollama -v.

• ❌ Ошибка: curl http://localhost:11434/api/tags не отвечает.

  ✅ Решение: Ollama не запущен. Выполните ollama для интерактивного запуска или, если вы на Linux и поднимаете сервер явно, используйте ollama serve.

• ❌ Ошибка: на Linux непонятно, почему сервис не поднимается.

  ✅ Решение: используйте документированные проверки systemctl status ollama и journalctl -e -u ollama. Они показывают текущее состояние и последние сообщения сервиса.

• ❌ Ошибка: Docker-контейнер запускается, но вы рассчитывали на NVIDIA GPU и не получили его.

  ✅ Решение: для NVIDIA документация отдельно требует NVIDIA Container Toolkit и параметр --gpus=all. Без них контейнерный запуск не соответствует документированному GPU-сценарию.

• ❌ Ошибка: вы пытаетесь использовать облачные функции или private-модели как локальный API без входа.

  ✅ Решение: локальный API не требует аутентификации, но для cloud models, publishing и downloading private models нужны ollama signin или API key — это отдельно указано в документации по аутентификации.

Безопасность и ограничения

• Локальный API по умолчанию не требует аутентификации. Это удобно для проверки и разработки, но важно помнить различие между локальным API и облачными сценариями.
• Для облачных моделей и private-моделей условия другие. В официальной документации указано, что cloud models, publishing и downloading private models требуют ollama signin или API key.
• Точные цены в этом пакете не собраны. Если вам важны платные условия облака, проверяйте их отдельно на актуальных официальных страницах.
• Матрица региональной доступности для локального ПО в источниках не зафиксирована. Если у вас корпоративные или географические ограничения, их нужно проверять отдельно.
• Прямые ссылки на конкретные установочные файлы в этом материале не жёстко зафиксированы. Это сознательное ограничение: в исходном пакете они не собраны как стабильные URL для публикации.

Что делать дальше

• Если Ollama уже установлен, переходите к следующему этапу: как настроить локальную модель через Ollama.
• Если хотите сравнить другой локальный сценарий запуска LLM, посмотрите как запустить LLM на своём компьютере через LM Studio.
• Если строите локальный или гибридный RAG-пайплайн, продолжайте с материалом как настроить векторную базу: Pinecone и Chroma.
• Если собираете соседний локальный стек для генерации изображений, пригодится инструкция как установить и запустить Stable Diffusion WebUI.

Источники

• Quickstart – Ollama
• Linux – Ollama
• macOS – Ollama
• Windows – Ollama
• Docker – Ollama
• Introduction – Ollama
• List models – Ollama
• Authentication – Ollama
• Releases · ollama/ollama · GitHub

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

Нужен ли аккаунт для локального запуска Ollama?

Нет, для локального API аутентификация не требуется. Но для cloud models, publishing и downloading private models в документации указаны ollama signin или API key.

Какой адрес у локального API по умолчанию?

По документации Ollama обслуживает локальный API по адресу http://localhost:11434/api.

Как проверить установку, если я ещё не загружал модели?

Сначала выполните ollama -v, затем curl http://localhost:11434/api/tags. Даже пустой список моделей в ответе означает, что сервер работает.

Какие минимальные версии ОС указаны официально?

Для macOS в документации указана macOS Sonoma 14+; для Windows — Windows 10 22H2 или новее. Linux поддерживается официально, а конкретный путь установки дан через shell-скрипт.

Какая версия Ollama актуальна на дату проверки этой инструкции?

На 2026-08-14 в GitHub Releases указаны v0.32.9 как latest stable и v0.32.10 как pre-release. Перед развёртыванием в продакшене перепроверьте страницу релизов ещё раз.