iiEsaywebUI/LOGO_SETUP.md

Инструкция по настройке логотипов и favicon в Open WebUI

Проблема: Логотипы не меняются

Open WebUI может использовать скомпилированные статические файлы или кешировать логотипы. Есть несколько способов решения.

Способ 1: Через Admin Panel (рекомендуется)

Это самый надежный способ, так как настройки сохраняются в базе данных.

1. Откройте Open WebUI: https://odo.iieasy.ru или http://localhost:3001
2. Войдите как администратор
3. Перейдите в Settings → Appearance (или Admin → Settings → **Appearance`)
4. Найдите секцию Logo или Branding
5. Загрузите ваши файлы:
   • Logo: media/logo.png или media/logo-light.svg
   • Favicon: media/favicon.png или media/favicon.ico
6. Сохраните изменения

Способ 2: Через скрипт ребрендинга + перезапуск

1. Убедитесь, что файлы есть в папке media/:

   ls -la media/logo* media/favicon*
   

2. Запустите скрипт ребрендинга:

   cd /home/its/iiEasyWeb
   sudo ./scripts/rebrand.sh
   

3. ВАЖНО: Перезапустите контейнер для применения изменений:

   sudo docker compose restart open-webui
   

4. Очистите кеш браузера:

   • Chrome/Edge: Ctrl+Shift+Delete → Очистить кеш изображений
   • Firefox: Ctrl+Shift+Delete → Кеш
   • Или используйте режим инкогнито: Ctrl+Shift+N

5. Обновите страницу с принудительной перезагрузкой: Ctrl+F5 или Ctrl+Shift+R

Способ 3: Прямое копирование в контейнер

Если скрипт не работает, скопируйте файлы вручную:

# Найдите где находятся favicon файлы
docker exec open-webui find /app -name "favicon.png" -o -name "favicon.ico" | head -5

# Скопируйте ваши файлы
docker cp media/favicon.png open-webui:/app/web/build/_app/immutable/favicon.png
docker cp media/logo.png open-webui:/app/web/build/_app/immutable/logo.png

# Перезапустите контейнер
docker compose restart open-webui

Способ 4: Использование монтированного volume

Файлы уже смонтированы в контейнер через volume:

• ./media:/app/media:ro
• ./media:/app/web/static/custom:ro

Можно использовать эти пути в настройках Open WebUI или скопировать оттуда:

# Скопировать из смонтированной папки в нужное место
docker exec open-webui cp /app/media/logo.png /app/web/build/_app/immutable/logo.png
docker exec open-webui cp /app/media/favicon.png /app/web/build/_app/immutable/favicon.png

Проверка

После применения изменений:

1. Откройте браузер в режиме инкогнито
2. Откройте https://odo.iieasy.ru или http://localhost:3001
3. Проверьте favicon во вкладке браузера
4. Проверьте логотип на странице

Если ничего не помогает

1. Проверьте в браузере (F12 → Network), какие файлы запрашиваются:

   • Откройте вкладку Network
   • Обновите страницу
   • Найдите запросы к favicon.* или logo.*
   • Посмотрите полный URL запроса

2. Найдите эти файлы в контейнере и замените их:

   docker exec open-webui find /app -path "*/favicon*" -o -path "*/logo*" | grep -v node_modules
   

3. Используйте Admin Panel Open WebUI - это самый надежный способ.

Настройка через переменные окружения (если поддерживается)

Некоторые версии Open WebUI поддерживают переменные окружения для логотипов. Добавьте в docker-compose.yml:

environment:
  - CUSTOM_LOGO_URL=/static/custom/logo.png
  - CUSTOM_FAVICON_URL=/static/custom/favicon.ico

Но лучше использовать Admin Panel, так как настройки сохраняются в базе данных.