Open WebUI для Ollama: как установить

Поставить Open WebUI проще всего одной командой Docker, после чего чат откроется в браузере по адресу http://localhost:3000. Допустим, Ollama у вас уже стоит и модель отвечает, но разговаривать с ней в чёрном окне терминала неудобно: нет истории, нет вкладок, файл не приложить. Open WebUI решает именно это: он выглядит как ChatGPT и показывает ваши локальные модели в браузере. Без Docker подойдут pip или uv, а новичку без терминала – Desktop-приложение.

Если Ollama ещё не стоит, начните со статьи «Ollama: установка на Windows, macOS и Linux и первые шаги». Для Windows есть отдельный разбор: Ollama на Windows.

Зачем вам Open WebUI, если есть Ollama?

Ollama работает в терминале и отдаёт API. Open WebUI добавляет к нему окно чата в браузере: с историей диалогов, переключением моделей, загрузкой файлов и учётными записями. Документация описывает его как самостоятельную платформу, которая работает с Ollama и с любыми OpenAI-совместимыми API.

Своих моделей у Open WebUI нет. Он только показывает те, что отдаёт Ollama или другой провайдер, так что скачивать модели всё равно придётся.

Если вы хотите подключать Ollama к своим программам, а не к чату, смотрите статью про Ollama API. Если выбираете между Ollama и графической программой, читайте сравнение с LM Studio.

Какой способ установки вам подойдёт?

Официальный Quick Start называет Docker рекомендуемым способом для большинства, Python – вариантом для маломощных систем и ручной настройки, а Desktop-приложение – способом без Docker и терминала. Сравнить все четыре способа проще в таблице: найдите строку, где «Для кого» похоже на вас.

Способ	Для кого	Что нужно	Плюсы	Минусы
Docker	Большинство пользователей, сервер, общий доступ для команды	Установленный Docker; скачивание образа около 1,62 ГБ (вариант :slim около 196 МБ)	Рекомендуемый способ; данные в отдельном томе; обновление заменой образа	Контейнеру нужно «достучаться» до Ollama на хосте; Docker надо ставить и осваивать
pip или uv	Слабые машины, ручная настройка, те, кто не хочет Docker	Python 3.11 (3.12 тоже работает, 3.13 пока не поддерживается)	Не нужен Docker; адрес Ollama находится автоматически	Зависимости ставятся в окружение, возможны конфликты версий; для продакшена документация советует Docker
Desktop-приложение	Новичок, один компьютер, без терминала	Установщик для Windows, macOS или Linux с GitHub	Скачал, запустил, работает	Репозиторий помечает его как «Early Alpha»; для рабочих развёртываний документация советует Docker или Python
VPS (сервер)	Доступ с разных устройств, команда, постоянная работа	Сервер с Docker; Ollama там же или на другой машине	Доступен из любой точки и 24 часа в сутки	Вы отвечаете за защиту, обновления и HTTPS; модели без видеокарты работают медленно

Kubernetes, Podman и Docker Swarm в документации тоже есть, но для домашней установки они вам не нужны. Дальше пойдём по порядку: сначала Docker, потому что его советуют чаще всего.

Как поставить Open WebUI через Docker?

Сначала поставьте Docker Desktop (Windows, macOS) или Docker Engine (Linux) и запустите Ollama. Затем сгенерируйте секретный ключ командой openssl rand -hex 32 и подставьте его вместо your-secret-key:

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY=your-secret-key --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Команда длинная, но каждая её часть нужна. Вот что они делают по документации:

• -p 3000:8080: интерфейс будет на порту 3000 вашего компьютера. Если порт занят, поменяйте левое число.
• -v open-webui:/app/backend/data: том с чатами, пользователями и настройками. Он переживает обновления, без него запускать нельзя.
• --add-host=host.docker.internal:host-gateway: позволяет контейнеру обратиться к Ollama на вашей машине.
• --restart always: контейнер поднимется после перезагрузки.
• -e WEBUI_SECRET_KEY: задайте один раз и сохраните. Без постоянного ключа каждое пересоздание контейнера разлогинивает всех пользователей.

Первый запуск занимает около минуты, так что не торопитесь. Потом откройте http://localhost:3000. Если страница не появилась, посмотрите логи: docker logs -f open-webui и дождитесь строки Application startup complete.

Что, если Ollama на другом сервере?

Тогда укажите её адрес через переменную OLLAMA_BASE_URL:

docker run -d -p 3000:8080 -e OLLAMA_BASE_URL=https://example.com -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Какой образ выбрать: slim, cuda или ollama?

Выбор зависит от того, что у вас за железо и что вы хотите делать в чате. Если сомневаетесь, берите стандартный :main.

• :main: стандартный образ, в нём встроены модели для распознавания речи и эмбеддингов.
• :slim: около 196 МБ вместо 1,62 ГБ (размеры сжатых слоёв для Linux/amd64 на 10 октября 2026). Подходит для чата с Ollama или API, но без локальной обработки документов и голоса.
• :cuda: для видеокарт Nvidia, добавьте --gpus all.
• :ollama: Open WebUI и Ollama в одном контейнере.

Одно предупреждение про теги. Тег :main всегда указывает на последнюю сборку ветки main, и она может содержать изменения без предупреждения. Для общего или рабочего сервера документация советует закрепить версию, например :v0.12.3.

А если Docker не нужен: pip или uv?

Тогда вам понадобится Python 3.11. Документация прямо предупреждает: Python 3.13 пока не поддерживается, установка на нём может упасть или сломаться при работе. Сами команды короткие:

pip install open-webui
open-webui serve

Интерфейс откроется на http://localhost:8080. Через uv можно обойтись без отдельной установки пакета (Linux и macOS):

DATA_DIR=~/.open-webui uvx --python 3.11 open-webui@latest serve

В PowerShell на Windows:

$env:DATA_DIR="C:\open-webui\data"; uvx --python 3.11 open-webui@latest serve

Переменная DATA_DIR задаёт папку с вашими данными. Документация советует задавать её всегда, чтобы чаты и настройки лежали в известном месте. Порт меняется ключом: open-webui serve --port 9999.

Из документации есть ещё два замечания. Первое: на Linux x86_64 без видеокарты Nvidia сначала поставьте облегчённый PyTorch командой pip install torch --index-url https://download.pytorch.org/whl/cpu, иначе подтянутся библиотеки CUDA. Второе: при запуске open-webui serve ключ сессий пишется в файл .webui_secret_key в текущей папке. Поэтому запускайте из одной и той же папки или задайте WEBUI_SECRET_KEY.

Подойдёт ли Desktop-приложение?

Если терминал вас пугает, да, но с оговорками. У Open WebUI есть официальное приложение для Windows (x64 и ARM64), macOS (Apple Silicon и Intel) и Linux, репозиторий github.com/open-webui/desktop. Установщик скачивается с GitHub, Docker и терминал не нужны. Приложение запускает Open WebUI на вашем компьютере или подключается к удалённому серверу Open WebUI.

Прежде чем ставить, учтите три вещи:

• README помечает приложение как «Early Alpha»: возможны поломки. Последний релиз на октябрь 2026: v0.0.20 от 6 мая 2026.
• Для встроенных локальных моделей (движок llama.cpp) README указывает 16 ГБ памяти и 5 ГБ диска. Для режима «только подключение к серверу» хватает 4 ГБ памяти и около 500 МБ диска.
• Приложение запускается на порту 8080, как вариант на Python.

Как войти и подключить Ollama?

Контейнер запущен, и теперь осталось дойти до первого сообщения. Шаги одинаковы для всех способов, различается только адрес.

1. Откройте http://localhost:3000 (Docker) или http://localhost:8080 (Python и Desktop).
2. На экране «Get started with Open WebUI» нажмите «Create Admin Account». Первый созданный аккаунт становится администратором: он управляет пользователями и общими настройками. Данные хранятся у вас, в томе.
3. После создания администратора регистрация отключается. Чтобы пустить других, включите «New Sign Ups» в Settings → Admin → Authentication; новые аккаунты ждут одобрения в Admin Panel.
4. Откройте Settings → Admin → Connections. Ollama на этой же машине Open WebUI находит сам: из Docker по адресу http://host.docker.internal:11434, из Python по http://localhost:11434.
5. Скачайте модель: введите её название в выборе модели в новом чате и подтвердите загрузку. Какую модель взять под ваше железо, читайте в подборке моделей для Ollama.
6. Нажмите New Chat, выберите модель и отправьте сообщение.

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

Как вам обновить Open WebUI?

Данные лежат в томе, а не в контейнере, поэтому обновление заменяет только образ. Перед обновлением сделайте копию тома и прочитайте заметки к релизу: миграции базы бывает трудно откатить. Для Docker:

docker rm -f open-webui
docker pull ghcr.io/open-webui/open-webui:main
docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY="your-secret-key" --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Ключ WEBUI_SECRET_KEY должен остаться тем же. Для Docker Compose достаточно docker compose pull и docker compose up -d. Для pip: pip install -U open-webui, затем open-webui serve. После обновления очистите кэш браузера (Ctrl+F5).

Что делать, если что-то не работает?

Чаще всего ломается одно из трёх: Open WebUI не видит Ollama, список моделей пуст или страница не открывается. Начните с того, что похоже на ваш случай.

Что делать, если он не видит Ollama?

Это самая частая жалоба. В документации два основных решения.

1. Ollama слушает только localhost. Задайте OLLAMA_HOST=0.0.0.0 в окружении Ollama (служба systemd, Docker или профиль оболочки) и перезапустите Ollama. Для Open WebUI в Docker это нужно, если Ollama работает на хосте.
2. Контейнер не достаёт до хоста. Проверьте, что в команде есть --add-host=host.docker.internal:host-gateway. Если не помогло, запустите контейнер в сети хоста. Порт тогда меняется с 3000 на 8080:

docker run -d --network=host -v open-webui:/app/backend/data -e OLLAMA_BASE_URL=http://127.0.0.1:11434 --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Откройте http://localhost:8080. Для Podman вместо host.docker.internal документация указывает host.containers.internal.

Что делать, если список моделей пуст?

Проверьте адрес Ollama в Settings → Admin → Connections. Если Ollama на другой машине, задайте OLLAMA_BASE_URL или впишите адрес в самом соединении.

Что значит «Open WebUI backend required»?

Так выглядит ошибка, когда браузер не достучался до /api/config по тому же адресу. Чаще всего неверно проброшен порт: внутри контейнера всегда нужен порт 8080, например -p 3001:8080. Проверка: curl http://localhost:3001/api/config должен вернуть JSON.

Что делать, если забыли пароль админа?

Кнопки «забыли пароль» для администратора нет. Документация описывает ручной сброс: создать bcrypt-хеш нового пароля (htpasswd -bnBC 10 "" новый-пароль) и записать его в базу webui.db запросом UPDATE auth SET password='HASH' WHERE email='ваш-адрес';. Для Docker базу открывают через временный контейнер с подключённым томом open-webui. Пошаговая инструкция есть на странице Reset Admin Password в docs.openwebui.com. Перед правкой базы сделайте копию тома.

Что делать, если страница не открылась?

Подождите минуту: первый запуск долгий. Затем выполните docker logs -f open-webui и ждите Application startup complete. Если порт занят, поменяйте левое число в -p 3000:8080.

Нужен ли вам Open WebUI на сервере (VPS)?

Сервер нужен, если вы хотите открывать чат с телефона и из других городов или дать доступ коллегам. Схема та же: Docker, том и ключ. Отличается защита: перед тем как открывать порт наружу, прочитайте раздел Security в документации и поставьте HTTPS через обратный прокси. Как выбрать VPS и что проверить у провайдера, мы разбирали в материале про хостинг для Telegram-бота. Если вам нужен не чат, а локальный агент, смотрите установку агента на ПК.

Главный вопрос здесь – сколько памяти брать, и ответ состоит из двух частей:

• Самому Open WebUI. В документации нет официальной цифры требований к памяти для сервера. Известно, что образ :main скачивается размером 1,62 ГБ, а :slim около 196 МБ. Подберите запас по факту: запустите и посмотрите docker stats open-webui.
• Модели. README Desktop-приложения даёт ориентир для локальных моделей: 7B примерно 8 ГБ памяти, 13B примерно 16 ГБ. Это ориентир для готовых моделей, а не гарантия для вашей.

Отсюда вывод: небольшой сервер без видеокарты подходит для самого Open WebUI, который подключается к внешнему API или к Ollama на другой машине. Если же запускать модель на таком сервере, она пойдёт на процессоре, и ответы будут заметно медленнее, чем на компьютере с видеокартой. Точные скорости зависят от модели и процессора, поэтому сначала проверьте её на тестовом тарифе.

Если нужен сервер в России:

• Beget: посуточная оплата, удобно для проб.
• Timeweb Cloud: облачные серверы (VPS).

Реклама. Партнёрская ссылка. Тарифы и цены смотрите на сайтах провайдеров.

Что не так с лицензией Open WebUI?

С версии v0.6.6 (19 апреля 2025) лицензия Open WebUI – BSD-3 с дополнительным пунктом о брендинге. Код до v0.6.5 остаётся под обычной BSD-3. Пункт запрещает убирать и менять название «Open WebUI», логотип и другие знаки. Исключений три: у вас не больше 50 пользователей за 30 дней, вы получили письменное разрешение владельца, либо у вас корпоративная лицензия.

Что это значит для вас. Если вы ставите Open WebUI для себя, семьи или небольшой команды, ограничений на практике нет: использовать и настраивать можно свободно. Если же хотите продавать интерфейс клиентам под своим именем и убрать название, нужно оформлять разрешение. Это не юридическая консультация, точный текст читайте в файле LICENSE репозитория.

Что ещё вы хотите узнать?

Нужен ли вам Docker?

Нет. Можно поставить через pip, uv или Desktop-приложение. Docker рекомендован документацией для большинства пользователей и для сервера.

Почему порт 3000, а не 8080?

Внутри контейнера Open WebUI работает на 8080. Опция -p 3000:8080 показывает его на порту 3000 вашего компьютера. При установке через Python или в сети хоста порт остаётся 8080.

Нужна ли вам видеокарта?

Самому Open WebUI нет. Видеокарта влияет на скорость модели в Ollama. Для ускорения встроенных моделей Open WebUI есть образ :cuda.

Где хранятся ваши чаты?

В Docker-томе open-webui, а при установке через Python в папке DATA_DIR. Они сохраняются при обновлении, если том не удалять.

Можно ли поставить его вместе с Ollama?

Да, одним контейнером: используйте образ :ollama, например без видеокарты: docker run -d -p 3000:8080 -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:ollama. С видеокартой Nvidia добавьте --gpus=all.

Можно ли подключить облачные модели?

Да, Open WebUI работает с любым OpenAI-совместимым API. Ключ добавляется в Settings → Admin → Connections. Доступность и оплату зарубежных сервисов из России проверяйте отдельно; про оплату есть отдельная статья.

Как удалить Open WebUI?

Для Docker удалите контейнер командой docker rm -f open-webui. Том с данными удалять не обязательно: он останется, пока вы не удалите его сами. Для pip: pip uninstall open-webui и папка DATA_DIR.

Что у вас получилось в итоге?

Если всё прошло гладко, вы теперь открываете браузер вместо терминала, а ваша модель отвечает в привычном окне чата с историей и файлами. Если нет, большинство сбоев лечится двумя вещами: OLLAMA_HOST=0.0.0.0 и правильным адресом в Connections.

Напоследок про сроки. Все команды взяты из официальной документации на октябрь 2026, а последняя версия на момент проверки – v0.12.3 от 16 октября 2026. Версии, размеры образов и поведение Desktop-приложения меняются, поэтому перед установкой сверьтесь с документацией.