Ana içeriğe geç

🖥️ Masaüstü Uygulaması

Libre WebUI masaüstü uygulaması web arayüzünü macOS, Windows ve Linux’ta yerel pencereye sarar. Aynı makinedeki veya belirttiğiniz herhangi bir Libre WebUI sunucusuna bağlanır.

Uygulama ayrı depoda geliştirilir; her sürümün kurucuları ana deponun GitHub sürümlerine eklenir.

📦 İndirme ve Kurma​

Son sürümden platform paketini alın:

  • macOS (Apple Silicon): Libre-WebUI-Desktop-{version}-mac-arm64.dmg veya .zip, ya da brew install --cask libre-webui/tap/libre-webui-desktop
  • Windows: Libre-WebUI-Desktop-Setup-{version}.exe (kurucu) veya Libre-WebUI-Desktop-{version}.exe (taşınabilir)
  • Linux: Libre-WebUI-Desktop-{version}.AppImage veya Libre-WebUI-Desktop-{version}-{arch}.deb

Yeniden adlandırmadan önce paketler Libre-WebUI-Frontend, uygulama Libre WebUI Frontend.app adını taşıyordu.

macOS uygulamayı hasarlı sayıyor​

macOS derlemeleri geçici olarak ad-hoc imza kullanır. Paket yapısını geçerli tutar ancak Apple’a yayıncıyı tanıtmaz ve noterlenemez. Applications’a kopyaladıktan sonra System Settings → Privacy & Security → Open Anyway ile onaylayın.

Seçenek yoksa yalnızca resmi sürümü doğruladıktan sonra karantinayı kaldırın:

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

Gatekeeper’ı genel kapatmayın. Sorunsuz dağıtım Developer ID Application sertifikası ve Apple noterliği gerektirir.

🔌 Sunucuya Bağlanma​

Uygulama istemcidir ve sunucu ister. İlk açılışta:

  • Yerel: makinenizde 3001 portundaki sunucuyu arar ve sağlık kontrolünden sonra bağlanır.
  • Uzak: ev laboratuvarı veya ekip dağıtımı gibi ulaşılabilir sunucu URL’sini girersiniz; uygulama önce doğrular.

Seçim hatırlanır. Değiştirmek için Libre WebUI → Switch Server… menüsünü kullanın. Hatırlanan sunucu yanıt vermezse boş pencere yerine başlangıç ekranına döner.

Yerel sunucu için Hızlı Başlangıç: Docker Compose, npx libre-webui ve Homebrew çalışır.

🧰 Masaüstünde Work​

Paket backend, Docker veya Work kapsayıcı çalışma zamanı içermez. Kullanılabilirliği sunucu belirler:

  • docker info çalıştırabilen yerel backend görev kapsayıcıları ve birimler oluşturur;
  • standart Compose ana bilgisayar socket’ini bağlar, ulaşılabilir çalışma zamanı olmayan özel kapsayıcı Work’ü kullanılamaz gösterir;
  • Helm work.enabled=true ile Kubernetes Pod/PVC Work sağlar; ve
  • Work yokken Chat çalışır.

Dosyalar uygulamada değil sunucunun Docker veya Kubernetes deposundadır. Önizlemeler imzalı aynı kökenli proxy üzerinden gider; sunucunun reverse proxy’si HTTP/WebSocket’i korursa yerel ve uzak istemciler kullanabilir.

🎨 Masaüstü Entegrasyonu​

  • Uygulama, düzenleme, görünüm, pencere ve yardım menüleri
  • Kenar çubuğunda macOS hiddenInset başlık çubuğu
  • Sistem tercihine uyan koyu mod
  • Harici bağlantılar varsayılan tarayıcıda açılır
  • Renderer bağlam yalıtımıyla ve Node entegrasyonu olmadan çalışır

🚧 Sınırlamalar​

  • macOS mimarisi: yalnızca Apple Silicon (arm64)
  • Sunucu gerekir: backend pakette değildir
  • Work sunucuya bağlıdır: Docker/Kubernetes içermez
  • Otomatik güncelleme yoktur: yeni paket elle indirilir

Çalışma zamanı, sağlayıcı, depolama ve önizleme güvenliği için Work: yalıtılmış çalışma alanları.