Open WebUI: веб-інтерфейс для Ollama на VDS

Що таке Open WebUI?

Open WebUI — веб-інтерфейс для взаємодії з мовними моделями, який можна розмістити самостійно. Підтримує Ollama, OpenAI API та інші бекенди.

Встановлення через Docker

curl -fsSL https://get.docker.com | sh

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

--network=host дозволяє контейнеру звертатися до Ollama напряму через localhost без додаткової конфігурації.

Налаштування Nginx reverse proxy

server {
    listen 80;
    server_name ai.yourdomain.com;
    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_read_timeout 300s;
    }
}
certbot --nginx -d ai.yourdomain.com

Основні можливості

Чат із будь-якими моделями Ollama в зручному інтерфейсі
Завантаження документів (PDF, DOCX) для RAG
Створення системних промптів
Багатокористувацький режим із ролями
Історія діалогів і пошук за нею
Підтримка зображень (мультимодальні моделі)

Перший вхід

Відкрийте http://YOUR_SERVER_IP:8080. Перший зареєстрований обліковий запис автоматично стає адміністратором.

Безпека: Встановіть SSL-сертифікат перед відкриттям для зовнішнього доступу. Без HTTPS паролі передаються відкритим текстом.

Часті помилки під час налаштування

Інтерфейс відкривається, але список моделей порожній

Failed to fetch models: Network Error

Найчастіше причина в неправильному OLLAMA_BASE_URL або в тому, що Ollama й Open WebUI не бачать одне одного мережею. Під час запуску без --network=host усередині контейнера адреса 127.0.0.1 вказує на сам контейнер, а не на хост з Ollama — потрібен host.docker.internal або спільна Docker-мережа.

Після certbot сайт не відкривається по HTTPS

502 Bad Gateway

502 означає, що Nginx прийняв запит, але не зміг отримати відповідь від бекенда. Перевірте, що контейнер Open WebUI дійсно слухає порт, вказаний у proxy_pass, і що він не впав після старту — подивіться docker logs open-webui.

Завантаження PDF для RAG зависає без відповіді

Розбір великих документів на ембеддинги — важка за CPU операція. На слабкому VDS без GPU обробка обʼємного PDF може займати помітний час; це не зависання, а нестача обчислювальних ресурсів. Слідкуйте за використанням CPU через docker stats під час завантаження.

«Sign up is disabled» під час спроби зареєструвати другого користувача

Sign up is disabled

Після створення першого адміністратора або за явної змінної оточення, що забороняє відкриту реєстрацію, форма реєстрації вимикається за умовчанням із міркувань безпеки. Нових користувачів у цьому режимі заводить адміністратор вручну через панель керування, або потрібно тимчасово увімкнути реєстрацію в налаштуваннях.

Open WebUI та альтернативні інтерфейси

Усі три варіанти дають чат поверх LLM, але по-різному розвʼязують питання кастомізації і володіння кодом інтерфейсу.

Критерій	Open WebUI	LibreChat	Власний фронтенд
Поріг входу	Низький	Низький	Високий
Підтримка кількох бекендів LLM	Так	Так	Залежить від реалізації
Кастомізація UI під бренд	Обмежена	Обмежена	Повна
Мультикористувацький режим з коробки	Так	Так	Пишеться вручну

Коли Open WebUI не підходить

Готовий інтерфейс економить тижні розробки, але не вирішує завдання, для яких потрібен повний контроль над версткою і логікою.

Потрібен фірмовий інтерфейс під бренд компанії — Open WebUI змінюється через налаштування теми, але не замінює повноцінну кастомну фронтенд-розробку
Продукт вбудовується як віджет на наявний сайт — для цього потрібен власний компонент, що звертається до API напряму
Єдине завдання — програмний доступ до моделей без UI — тоді веб-інтерфейс просто зайвий шар, достатньо REST API Ollama
Потрібен суворіше контрольований мультитенантний білінг за токенами — для цього знадобиться окремий проксі-шар поверх Open WebUI
Реєстрація користувачів має проходити через корпоративний SSO без ручних кроків адміністратора — з коробки такий сценарій вимагає додаткового налаштування

Перевірка результату

Перш ніж відкривати доступ команді, варто пройти шлях нового користувача від входу до першої відповіді моделі.

Відкрийте інтерфейс у браузері і переконайтеся, що у випадному списку зʼявилися завантажені в Ollama моделі
Надішліть тестове повідомлення і дочекайтеся повної відповіді без обриву зʼєднання
Перевірте, що HTTPS працює без попереджень браузера про сертифікат
Завантажте тестовий документ і переконайтеся, що RAG-пошук знаходить у ньому релевантні фрагменти
Перевірте вхід під другим акаунтом, щоб переконатися, що багатокористувацький режим налаштовано вірно

За темою: сама модель під цим інтерфейсом — встановлення Ollama, відповіді за документами без UI — RAG на VDS.

Часті питання

Що буде, якщо хтось сторонній встигне зареєструватися на сервері раніше за власника?

Перший зареєстрований обліковий запис у системі автоматично отримує права адміністратора — без перевірки особи. Якщо відкрити доступ до сервера до власної реєстрації, випадковий відвідувач теоретично здатен випередити власника і забрати собі адмінку. Тому реєстрацію варто закрити або обмежити доступ мережею одразу після встановлення, а не лишати порт відкритим до першого входу.

Чи можна підключити до Open WebUI моделі не лише від Ollama, а й з інших джерел?

Так, інтерфейс від самого початку підтримує декілька бекендів одночасно: окрім Ollama це OpenAI-сумісний API та інші джерела моделей. Це дає змогу зібрати в одному чаті моделі з різних місць без окремих інструментів під кожну — перемикання між ними відбувається прямо в інтерфейсі, а не вимагає зміни адреси чи перезапуску контейнера.

Чи потрібна потужна відеокарта для самого інтерфейсу, чи вона потрібна лише роботі моделі?

Сам інтерфейс — легка вебпанель, і відеокарта йому як такова не потрібна. Навантаження на GPU створює модель усередині Ollama і розбір документів на ембеддинги для пошуку за ними: на слабкому сервері без GPU саме завантаження обʼємних файлів може помітно підвисати, а не сам чат. Варто мати це на увазі під час вибору конфігурації сервера для встановлення.

Що обрати, якщо потрібен повністю фірмовий дизайн чату, а не готова тема оформлення?

Готовий інтерфейс змінюється лише через налаштування теми і не перетворюється на повноцінну кастомну розробку під бренд компанії. Якщо важливий контроль над версткою, логікою і стилем аж до дрібниць, розумніше писати власний фронтенд, який звертається до API напряму, а не підлаштовувати готове рішення під завдання, для яких воно спочатку не призначалося.