Установка Open WebUI локально: пошаговый гайд

Open WebUI — это мощный, красивый и полностью автономный веб-интерфейс для работы с локальными языковыми моделями (LLM). Он позволяет превратить ваш домашний сервер, игровой ПК или даже Raspberry Pi в полноценную AI-платформу. Инструмент поддерживает интеграцию с Ollama, LMStudio, vLLM и любыми OpenAI-совместимыми API. Это идеальный выбор для практиков, которые хотят сохранить приватность данных, избежать подписок на облачные сервисы и получить гибкий интерфейс с поддержкой RAG, плагинов и многопользовательского режима.

01Требования

Для стабильной работы Open WebUI вам потребуется базовое железо и настроенное окружение. Сам интерфейс (веб-фронтенд) очень легковесен, но «мозги» — модель — потребляют ресурсы.

• Операционная система: Linux (Ubuntu/Debian/CentOS), macOS или Windows (через WSL2 или Docker Desktop). Для Linux рекомендуется использовать нативную установку Docker.
• RAM: Для работы самого контейнера и интерфейса требуется минимальный объем оперативной памяти. Однако, если вы планируете запускать модели локально через Ollama, объем оперативной памяти критичен. Для моделей среднего размера требуется значительно больше ресурсов.
• VRAM (Видеопамять): Если у вас есть NVIDIA GPU, это значительно ускорит генерацию.
  • Минимальный объем VRAM: Подходит для квантованных моделей меньшего размера.
  • Средний объем VRAM: Позволяет запускать модели среднего размера в полном разрешении или в квантовании.
  • Большой объем VRAM: Необходим для моделей высокого размера в полном разрешении или моделей большего размера в квантовании.
• Python: Не требуется, если вы используете Docker (рекомендуемый способ). Если выбираете установку через pip, нужен актуальный Python.
• Драйверы: Для NVIDIA GPU необходимы установленные драйверы и nvidia-container-toolkit (для Linux).

02Установка

Самый надежный и простой способ установки Open WebUI — использование Docker. Это изолирует приложение от вашей основной системы и упрощает обновления.

Шаг 1. Установка Docker и Docker Compose

Если у вас еще не установлен Docker, выполните стандартные команды для вашей ОС. Для Ubuntu/Debian:

sudo apt-get update
sudo apt-get install docker.io docker-compose-plugin
sudo systemctl enable docker
sudo systemctl start docker

Шаг 2. Подготовка директории

Создайте папку для данных Open WebUI, чтобы сохранить историю чатов и настройки после перезагрузки контейнера:

mkdir -p ~/open-webui
chmod 777 ~/open-webui

Шаг 3. Запуск контейнера

Запустите контейнер Open WebUI. Мы монтируем папку ~/open-webui внутрь контейнера для сохранения данных. Если вы используете Ollama на той же машине, убедитесь, что он запущен и доступен по сети (по умолчанию Ollama слушает стандартный порт).

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v ~/open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main

Флаг --add-host=host.docker.internal:host-gateway критически важен для Linux, так как он позволяет контейнеру Docker обращаться к сервисам, запущенным на хост-машине (в данном случае к Ollama).

03Первый запуск

После успешного запуска контейнера откройте браузер и перейдите по адресу:

http://localhost:3000

Вы увидите страницу регистрации. Поскольку это ваш локальный сервер, вы можете создать первого администратора. Введите имя пользователя и пароль. После входа вы попадете в панель управления.

Подключение Ollama:

1. Перейдите в Settings (Настройки) → Connections (Подключения).
2. В поле Ollama Base URL введите: http://host.docker.internal:11434 (для Linux) или http://localhost:11434 (для macOS/Windows).
3. Нажмите Save.

Загрузка модели:

Перейдите в Settings → Models. Нажмите Fetch New Models. Если Ollama запущен, список доступных моделей загрузится автоматически. Выберите любую модель (например, llama3.1 или mistral) и нажмите Download.

После загрузки модель появится в списке. Выберите её в выпадающем списке в чате и начните общение. Интерфейс поддерживает Markdown, LaTeX, загрузку файлов (RAG) и голосовой ввод.

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

1. Ошибка подключения к Ollama (Connection Refused):
   • Причина: Open WebUI не видит Ollama.
   • Решение: На Linux используйте host.docker.internal. Проверьте, запущен ли Ollama командой ollama list в терминале хоста. Убеди

     Источник: Open WebUI (офиц. документация) ↗