Hoppa till huvudinnehåll

🖥️ Skrivbordsapp

Libre WebUI:s skrivbordsapp visar webbgränssnittet i ett inbyggt fönster för macOS, Windows och Linux. Den ansluter till en Libre WebUI-server på samma dator eller en valfri server som du anger.

Appen utvecklas i ett eget repository. Installationsprogram för varje utgåva bifogas huvudrepositoryts GitHub-utgåvor.

📦 Hämta och installera​

Hämta paketet för din plattform från den senaste utgåvan:

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

Utgåvor före namnbytet levererade resurserna med prefixet Libre-WebUI-Frontend och programpaketet Libre WebUI Frontend.app.

macOS blockerar appen som skadad​

Libre WebUI använder tillfälligt en ad hoc-signatur för macOS-byggen. Den håller programpaketet strukturellt giltigt men identifierar inte utgivaren för Apple och kan inte notariseras. När programmet har kopierats till Applications godkänner du det under Systeminställningar → Integritet och säkerhet → Öppna ändå.

Om macOS inte erbjuder alternativet tar du bort karantänattributet först efter att ha verifierat att programmet kommer från den officiella Libre WebUI-utgåvan:

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

Inaktivera inte Gatekeeper globalt. Friktionsfri distribution kräver fortfarande ett Developer ID Application-certifikat och Apple-notarisering.

🔌 Ansluta till en server​

Appen är en klient och behöver en Libre WebUI-server. Vid första starten erbjuder välkomstskärmen två alternativ:

  • Lokal: appen söker efter en server på din dator (port 3001, standard för Docker-imagen och npx libre-webui) och ansluter när hälsokontrollen svarar.
  • Fjärr: ange URL:en till en nåbar Libre WebUI-server, exempelvis ett hemmalabb eller en teamdriftsättning. Appen verifierar den före anslutning.

Valet sparas. Byt server senare med Libre WebUI → Byt server… i menyfältet. Om en sparad server slutar svara återgår appen till välkomstskärmen i stället för ett tomt fönster.

Kör en lokal server enligt Snabbstart: Docker Compose, npx libre-webui och Homebrew fungerar alla.

🧰 Work i skrivbordsappen​

Skrivbordspaketet innehåller inte backend, Docker eller en Work-containerruntime. Work-tillgängligheten bestäms av servern:

  • en inbyggd backend som kan köra docker info kan skapa uppgiftsavgränsade Work-containrar och namngivna volymer;
  • repositoryts standard-Compose-driftsättning tillhandahåller Docker-baserat Work genom att montera värdens Docker-socket, medan en anpassad containerdriftsättning utan nåbar runtime rapporterar Work som otillgängligt;
  • en Kubernetes-server tillhandahåller Pod-/PVC-baserat Work när Helm-diagrammet installeras med work.enabled=true; och
  • appen stöder fortsatt Chatt när Work inte är tillgängligt.

Work-filer finns på serverns Docker-värd eller Kubernetes-lagring, inte i skrivbordsappen. Förhandsvisningar går genom Libre WebUI:s signerade same-origin-proxy, så lokala och fjärranslutna klienter kan använda dem när serverns reverse proxy bevarar HTTP- och WebSocket-trafik.

🎨 Skrivbordsintegrering​

  • Inbyggt menyfält med menyer för program, redigering, visning, fönster och hjälp
  • Anpassad macOS-titellist (hiddenInset) med trafikljus i sidofältet
  • Mörkt läge följer systeminställningen
  • Externa länkar öppnas i standardwebbläsaren, aldrig i appen
  • Renderaren körs med kontextisolering och utan Node-integrering

🚧 Begränsningar​

  • macOS-arkitektur: aktuella macOS-paket stöder endast Apple Silicon (arm64)
  • Kräver server: appen innehåller inte backend
  • Work beror på serverns runtime: ingen Docker- eller Kubernetes-runtime ingår
  • Inga automatiska uppdateringar: uppdatering kräver ett nytt paket

Se Work: Isolerade arbetsytor för säkerhetsinformation om runtime, leverantörer, lagring och förhandsvisningar.