Open WebUI: как установить и подключить к Ollama — свой чат для команды
Все статьи
AI / LLM 6 мин чтения

Open WebUI: как установить и подключить к Ollama — свой чат для команды

Установка Open WebUI через Docker и pip, подключение к Ollama, vLLM и llama.cpp, пользователи и права, чат с документами, лицензия и частые ошибки.

Установка Open WebUI через Docker и pip, подключение к Ollama, vLLM и llama.cpp, пользователи и права, чат с документами, лицензия и частые ошибки.

Коротко

Open WebUI — веб-интерфейс в стиле ChatGPT, который ставится на свой компьютер или сервер. Он подключается к локальным моделям через Ollama и к любому API, совместимому с OpenAI: vLLM, llama.cpp, LM Studio, облачным сервисам. Внутри — учётные записи и права для команды, чат с документами (RAG), поиск в интернете, голосовой ввод, инструменты и агенты. Может работать полностью без интернета. Интерфейс переведён на русский.

Самый быстрый способ, если Ollama уже установлена на этом же компьютере:

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY=ваш-ключ \
  --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Ключ сгенерируйте командой openssl rand -hex 32 и сохраните: без постоянного ключа при каждом пересоздании контейнера всех пользователей будет разлогинивать. После запуска откройте http://localhost:3000. Первая созданная учётная запись становится администратором.

Что умеет Open WebUI

  • Любые модели в одном окне. Локальные через Ollama и любые OpenAI-совместимые API — можно смешивать и переключаться в одном чате или опрашивать несколько моделей сразу.
  • Команда. Пользователи, группы, роли и права доступа к моделям; вход через LDAP/Active Directory, SSO и OAuth.
  • Чат с документами (RAG). Загрузка файлов в чат или в общую библиотеку знаний, гибридный поиск с переранжированием, на выбор девять векторных баз (ChromaDB, PGVector, Qdrant и другие).
  • Поиск в интернете через десятки поставщиков, в том числе SearXNG, Brave, DuckDuckGo.
  • Свои ассистенты. Модель плюс инструкции, инструменты и база знаний, с доступом для конкретных групп.
  • Инструменты и плагины. Фильтры, действия, подключение внешних сервисов через MCP и OpenAPI.
  • Голос, картинки, заметки, статистика. Голосовые звонки с моделью, генерация изображений, учёт сообщений и токенов по пользователям и моделям.

Способы установки

Docker (рекомендуется)

Ситуация Команда
Ollama на этом же компьютере docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
Ollama на другом сервере то же, но с -e OLLAMA_BASE_URL=http://адрес-сервера:11434 вместо --add-host…
Open WebUI и Ollama в одном контейнере, с видеокартой NVIDIA docker run -d -p 3000:8080 --gpus=all -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:ollama
То же без видеокарты та же команда без --gpus=all
Только облачный API OpenAI docker run -d -p 3000:8080 -e OPENAI_API_KEY=ваш_ключ -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Два важных момента:

  • Всегда указывайте -v open-webui:/app/backend/data. В этом томе хранятся база, пользователи и история. Без него при пересоздании контейнера всё пропадёт.
  • Какой образ выбрать. :main — стандартный, в нём уже есть модели для распознавания речи и поиска по документам (около 1,6 ГБ). :slim — около 200 МБ, без встроенных моделей, чат работает так же. :cuda — с поддержкой видеокарт NVIDIA (CUDA 12.8), для него на Linux или в WSL нужен NVIDIA Container Toolkit. :ollama — вместе с Ollama. Сами языковые модели в любом случае считает Ollama или другой сервер.

Через pip, без Docker

Нужен Python 3.11 или 3.12:

pip install open-webui
open-webui serve

Интерфейс откроется на http://localhost:8080. Разработчики также поддерживают установку через uv, Docker Compose, Kubernetes (kustomize, helm) и отдельное приложение для macOS, Windows и Linux.

Подключение моделей

Ollama

Если Open WebUI запущен в Docker, а Ollama — на этом же компьютере, контейнер обращается к ней по адресу host.docker.internal:11434 — для этого в команде и стоит --add-host=host.docker.internal:host-gateway. Модели, скачанные в Ollama, сразу появляются в списке. Новые модели можно скачивать прямо из интерфейса Open WebUI.

Какие модели взять под вашу видеокарту — в подборке «Модели для Ollama и LM Studio».

vLLM, llama.cpp, LM Studio и облачные API

Все они отдают API, совместимый с OpenAI. Подключение — в Настройках администратора → Подключения: добавьте адрес и ключ. Или переменными при запуске:

Сервер Адрес API
vLLM http://адрес:8000/v1
llama.cpp (llama-server) http://адрес:9931/v1
LM Studio http://адрес:1234/v1
-e OPENAI_API_BASE_URL=http://адрес:8000/v1 -e OPENAI_API_KEY=ключ

Несколько адресов для балансировки можно перечислить в OPENAI_API_BASE_URLS через точку с запятой. Если сервер работает на том же компьютере, а Open WebUI — в Docker, вместо localhost указывайте host.docker.internal.

Пользователи и доступ для команды

  • Первая учётная запись — администратор: она управляет пользователями и всеми настройками.
  • По умолчанию регистрация открыта (ENABLE_SIGNUP=True), но новые пользователи получают роль pending — ждут, пока администратор их активирует (DEFAULT_USER_ROLE). Для внутреннего сервера это разумно: случайный человек не получит доступ к моделям.
  • Группы и права позволяют открыть конкретные модели, ассистентов и базы знаний только нужным отделам.
  • Для компаний с каталогом пользователей есть LDAP/Active Directory, SSO через OAuth и автоматическое создание учётных записей по SCIM.

Если интерфейс доступен из интернета, поставьте перед ним HTTPS-прокси и не отключайте авторизацию.

Чат с документами

Документ можно прикрепить к сообщению или загрузить в «Знания» — общую библиотеку, к которой подключаются ассистенты. В чате библиотека вызывается символом #. Open WebUI разбивает документы на фрагменты, ищет нужные и передаёт их модели вместе с вопросом. Это простой способ сделать «нейросеть по документам компании» без разработки — но качество ответов надо проверять на своих документах. Как устроены такие системы и где у них слабые места, разбираем в статье «RAG для бизнеса».

Лицензия: можно ли использовать в компании

Код Open WebUI распространяется под собственной лицензией Open WebUI License. Пользоваться, изменять и разворачивать у себя можно бесплатно. Главное ограничение — нельзя убирать или заменять брендинг Open WebUI (название, логотип), если у развёртывания больше 50 пользователей за 30 дней, — для этого нужно письменное разрешение или корпоративная лицензия. Для внутреннего сервера с сохранённым логотипом ограничение не мешает. Перед запуском в компании прочитайте актуальный текст лицензии в репозитории.

Частые проблемы

Open WebUI не видит Ollama. Контейнер не может достучаться до 127.0.0.1:11434 на хосте. Проверьте флаг --add-host=host.docker.internal:host-gateway или запустите контейнер с --network=host — тогда интерфейс будет на порту 8080, а не 3000:

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

Пропала история после обновления. Контейнер запускали без тома -v open-webui:/app/backend/data.

Изменил переменную окружения, а в интерфейсе ничего не поменялось. Многие настройки сохраняются в базе при первом запуске, и дальше действует значение из базы. Поменяйте настройку в интерфейсе администратора.

Сервер без интернета. Задайте HF_HUB_OFFLINE=1, чтобы Open WebUI не пытался скачивать модели из интернета.

Open WebUI в компании

Связка «vLLM или Ollama на сервере + Open WebUI» — самый быстрый способ дать сотрудникам свой ChatGPT, данные которого не уходят во внешние сервисы. Сколько памяти нужно серверу под модель и число пользователей, можно прикинуть в калькуляторе видеопамяти. Если нужно развернуть такой сервер под ключ — посмотрите, как мы внедряем локальные LLM; все материалы по теме — на странице «Локальные LLM».

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

Что такое Open WebUI? Бесплатный веб-интерфейс в стиле ChatGPT для своих моделей. Ставится на компьютер или сервер, подключается к Ollama и к любому API, совместимому с OpenAI, поддерживает пользователей и права, чат с документами и поиск в интернете.

Как установить Open WebUI с Ollama? Если Ollama уже стоит на этом компьютере — командой docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY=ваш-ключ --name open-webui --restart always ghcr.io/open-webui/open-webui:main. Если Ollama нет — образом ghcr.io/open-webui/open-webui:ollama, в котором есть и то и другое.

Можно ли поставить Open WebUI без Docker? Да: pip install open-webui и open-webui serve на Python 3.11 или 3.12. Интерфейс откроется на http://localhost:8080.

Есть ли Open WebUI на русском? Да, интерфейс переведён на русский: язык выбирается в настройках.

Можно ли использовать Open WebUI в компании бесплатно? Да. Ограничение лицензии касается брендинга: убирать или менять логотип и название Open WebUI можно только при развёртывании до 50 пользователей за 30 дней или с разрешением правообладателя.

Источники

АП
Автор
Антон Правкин, основатель ITOQ

Внедряет ИИ и LLM в процессы компаний, разрабатывает платформы и чат-ботов. LinkedIn

ТемаВсе материалы про локальные LLM
Делаем это для бизнеса

Внедрение ИИ и разработка чат-ботов для бизнеса

Внедряем LLM в процессы компании: AI-агенты, Telegram-боты, автоматизация на n8n, облачные и локальные модели на своей инфраструктуре.

от 60 000 ₽ · от 2 недель

Подробнее об услуге и стоимости
CTA

Похожая задача в вашем бизнесе?

Расскажите коротко — предложим путь от аудита до запуска. Можно без формальностей.

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