Перейти до основного вмісту

🖥️ Настільний застосунок

Настільний застосунок Libre WebUI відкриває вебінтерфейс у рідному вікні macOS, Windows або Linux. Він підключається до сервера Libre WebUI на тій самій машині або за вказаною адресою.

Застосунок розробляється в окремому репозиторії, а інсталятори кожного випуску прикріплено до випусків GitHub основного репозиторію.

📦 Завантаження та встановлення​

Завантажте пакет своєї платформи з останнього випуску:

  • macOS (Apple Silicon): Libre-WebUI-Desktop-{version}-mac-arm64.dmg або .zip, чи brew install --cask libre-webui/tap/libre-webui-desktop
  • Windows: Libre-WebUI-Desktop-Setup-{version}.exe (інсталятор) або Libre-WebUI-Desktop-{version}.exe (переносна версія)
  • Linux: Libre-WebUI-Desktop-{version}.AppImage або Libre-WebUI-Desktop-{version}-{arch}.deb

До перейменування пакети мали префікс Libre-WebUI-Frontend, а застосунок називався Libre WebUI Frontend.app.

macOS повідомляє про пошкоджений застосунок​

Збірки macOS тимчасово використовують ad-hoc-підпис. Він зберігає правильну структуру пакета, але не підтверджує Apple особу видавця й не може бути нотаризований. Після копіювання до Applications схваліть у System Settings → Privacy & Security → Open Anyway.

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

xattr -dr com.apple.quarantine "/Applications/Libre WebUI Desktop.app"
open "/Applications/Libre WebUI Desktop.app"

Не вимикайте Gatekeeper глобально. Безперешкодне розповсюдження все одно потребує сертифіката Developer ID Application і нотаризації Apple.

🔌 Підключення до сервера​

Застосунок є клієнтом і потребує сервера. Під час першого запуску доступні два шляхи:

  • Локальний: пошук сервера на машині (порт 3001, типовий для Docker-образу та npx libre-webui) і підключення після успішної перевірки стану.
  • Віддалений: введення URL будь-якого досяжного сервера, наприклад домашнього або командного; застосунок перевіряє його до підключення.

Вибір запам’ятовується. Щоб змінити сервер, скористайтеся Libre WebUI → Switch Server… у меню. Якщо збережений сервер не відповідає, застосунок повертається до початкового екрана замість порожнього вікна.

Локальний сервер описано в Швидкому старті: підходять Docker Compose, npx libre-webui і Homebrew.

🧰 Work у настільному застосунку​

Пакет не містить серверної частини, Docker або середовища контейнерів Work. Доступність визначає підключений сервер:

  • рідний сервер, де працює docker info, може створювати контейнери й іменовані томи завдань;
  • стандартний Compose надає Work через socket Docker хоста, а власний контейнер без середовища показує Work як недоступний;
  • Kubernetes надає Work через Pod/PVC, якщо Helm установлено з work.enabled=true; та
  • Chat продовжує працювати, коли Work недоступний.

Файли Work зберігаються на Docker-хості або в Kubernetes, не в настільному застосунку. Перегляди передаються через підписаний проксі того самого походження, тому локальні й віддалені клієнти працюють, якщо зворотний проксі сервера зберігає HTTP і WebSocket.

🎨 Інтеграція з робочим столом​

  • Рідне меню застосунку, редагування, перегляду, вікна й довідки
  • Власна панель заголовка macOS (hiddenInset) з кнопками в бічній панелі
  • Темний режим відповідає системі
  • Зовнішні посилання відкриваються в типовому браузері, не в застосунку
  • Процес відтворення має ізоляцію контексту й не інтегрує Node

🚧 Обмеження​

  • Архітектура macOS: поточні пакети підтримують лише Apple Silicon (arm64)
  • Потрібен сервер: серверна частина не входить у пакет
  • Work залежить від середовища сервера: Docker або Kubernetes не входять у пакет
  • Без автоматичних оновлень: новий пакет потрібно завантажувати вручну

Докладніше про середовище, провайдерів, зберігання й безпеку перегляду — у Work: ізольовані робочі області.