Ga naar hoofdinhoud

🖥️ Desktop-app

De app verpakt de webinterface in een native venster en verbindt met een Libre WebUI-server op dezelfde machine of elders.

Ontwikkeling gebeurt in een eigen repository; installers staan bij GitHub-releases.

📦 Downloaden en installeren​

Via nieuwste release:

  • macOS (Apple Silicon): Libre-WebUI-Desktop-{version}-mac-arm64.dmg of .zip, of brew install --cask libre-webui/tap/libre-webui-desktop
  • Windows: Libre-WebUI-Desktop-Setup-{version}.exe of Libre-WebUI-Desktop-{version}.exe
  • Linux: Libre-WebUI-Desktop-{version}.AppImage of Libre-WebUI-Desktop-{version}-{arch}.deb

Voor de naamswijziging heetten bestanden Libre-WebUI-Frontend en Libre WebUI Frontend.app.

macOS meldt beschadiging​

De builds gebruiken tijdelijk een ad-hoc-handtekening. Die houdt de bundel geldig maar identificeert de uitgever niet en kan niet worden genotariseerd. Kopieer naar Applications en keur goed via Systeeminstellingen → Privacy en beveiliging → Toch openen.

Alleen na controle van de officiële release:

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

Schakel Gatekeeper niet globaal uit. Naadloze distributie vereist Developer ID Application en notarization.

🔌 Met een server verbinden​

  • Lokaal: zoekt op poort 3001 en verbindt na healthcheck.
  • Extern: voer een bereikbare URL in; de app controleert die.

De keuze wordt onthouden. Gebruik Libre WebUI → Andere server… om te wisselen. Een onbereikbare opgeslagen server keert terug naar het startscherm.

Zie Snel starten voor Docker Compose, npx libre-webui en Homebrew.

🧰 Work​

De desktop-app bevat geen backend, Docker of Work-runtime. Beschikbaarheid hangt af van de server:

  • native backend met docker info;
  • standaard Compose met hostsocket;
  • Kubernetes met work.enabled=true;
  • Chat blijft werken zonder Work.

Bestanden staan op de server. Voorbeelden gaan door de ondertekende same-originproxy en vereisen behoud van HTTP/WebSocket door de reverse proxy.

🎨 Integratie​

  • Native menu's
  • macOS-titelbalk hiddenInset
  • Systeemdonkere modus
  • Externe links in standaardbrowser
  • Contextisolatie zonder Node-integratie

🚧 Beperkingen​

  • macOS alleen Apple Silicon arm64
  • Server vereist
  • Work afhankelijk van serverruntime
  • Geen automatische updates

Zie Work: geïsoleerde werkruimten.