Add project and deployment instruction (docs/DEPLOYMENT.md)

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-19 18:12:09 +00:00
commit 53c572ef46
94 changed files with 9200 additions and 0 deletions
--- a/FIX_OLLAMA_URL.md
+++ b/FIX_OLLAMA_URL.md
@@ -0,0 +1,86 @@
+# Исправление проблемы с OLLAMA_BASE_URL
+
+## Проблема
+В контейнере Open WebUI переменная `OLLAMA_BASE_URL=/ollama` вместо правильного значения `http://ollama:11434`.
+
+Это приводит к тому, что изображения не передаются в Ollama, так как используется неправильный URL.
+
+## Решение
+
+### Шаг 1: Убедитесь, что в docker-compose.yml правильное значение
+
+В файле `/home/its/iiEasyWeb/docker-compose.yml` на строке 102 должно быть:
+```yaml
+      - OLLAMA_BASE_URL=http://ollama:11434
+```
+
+### Шаг 2: Перезапустите контейнер Open WebUI
+
+```bash
+cd /home/its/iiEasyWeb
+docker compose restart open-webui
+```
+
+Или полностью пересоздайте:
+```bash
+docker compose up -d --force-recreate open-webui
+```
+
+### Шаг 3: Проверьте переменную в контейнере
+
+```bash
+sudo docker exec open-webui env | grep OLLAMA_BASE_URL
+```
+
+Должно быть:
+```
+OLLAMA_BASE_URL=http://ollama:11434
+```
+
+### Шаг 4: Проверьте настройки в веб-интерфейсе
+
+1. Откройте https://odo.iieasy.ru
+2. Перейдите в **Settings → Connections → Ollama API**
+3. Убедитесь, что адрес: **`http://ollama:11434`**
+   - НЕ `/ollama`
+   - НЕ `host.docker.internal:11434`
+   - НЕ `localhost:11434`
+   - Должно быть именно `http://ollama:11434`
+
+### Шаг 5: Сохраните настройки
+
+После изменения адреса в веб-интерфейсе нажмите **"Сохранить"**.
+
+### Шаг 6: Проверьте работу
+
+1. Откройте чат с моделью `gemma3n:e4b-it-fp16`
+2. Загрузите изображение
+3. Задайте вопрос о изображении
+4. Проверьте логи Ollama - должны появиться запросы с изображениями:
+
+```bash
+sudo docker logs ollama -f | grep -i "image\|vision\|generate"
+```
+
+## Почему это важно
+
+Open WebUI использует `OLLAMA_BASE_URL` для формирования полного URL к Ollama API. Если значение неправильное (`/ollama` вместо `http://ollama:11434`), запросы не будут доходить до Ollama, и изображения не будут обрабатываться.
+
+## Дополнительная диагностика
+
+Если после перезапуска проблема сохраняется:
+
+1. Проверьте логи Open WebUI при отправке изображения:
+```bash
+sudo docker logs open-webui -f | grep -i "ollama\|image\|error"
+```
+
+2. Проверьте сеть Docker:
+```bash
+sudo docker network inspect iieasy-ai | grep -A 5 ollama
+```
+
+3. Проверьте доступность Ollama из Open WebUI:
+```bash
+sudo docker exec open-webui curl -s http://ollama:11434/api/tags | head -5
+```