Hop til hovedindhold

🖥️ Skrivebordsapp

Libre WebUI's skrivebordsapp viser webgrænsefladen i et integreret vindue på macOS, Windows og Linux. Den forbinder til en Libre WebUI-server på samme maskine eller en valgfri server, du angiver.

Appen udvikles i sit eget repository. Installationsprogrammer til hver udgivelse er vedhæftet hovedrepositoryts GitHub-udgivelser.

📦 Hent og installér​

Hent pakken til din platform fra den seneste udgivelse:

  • 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 (bærbar)
  • Linux: Libre-WebUI-Desktop-{version}.AppImage eller Libre-WebUI-Desktop-{version}-{arch}.deb

Udgivelser før navneændringen leverede aktiverne med præfikset Libre-WebUI-Frontend og programpakken Libre WebUI Frontend.app.

macOS blokerer appen som beskadiget​

Libre WebUI bruger midlertidigt en ad hoc-signatur til macOS-builds. Den holder programpakken strukturelt gyldig, men identificerer ikke udgiveren over for Apple og kan ikke notariseres. Når programmet er kopieret til Applications, godkendes det under Systemindstillinger → Anonymitet og sikkerhed → Åbn alligevel.

Hvis macOS ikke tilbyder indstillingen, fjernes karantæneattributten først efter kontrol af, at programmet kommer fra den officielle Libre WebUI-udgivelse:

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

Deaktiver ikke Gatekeeper globalt. Problemfri distribution kræver stadig et Developer ID Application-certifikat og Apple-notarisering.

🔌 Forbindelse til en server​

Appen er en klient og kræver en Libre WebUI-server. Ved første start tilbyder velkomstskærmen to muligheder:

  • Lokal: appen søger efter en server på din maskine (port 3001, standarden for Docker-imagen og npx libre-webui) og forbinder, når helbredskontrollen svarer.
  • Fjern: angiv URL'en til en tilgængelig Libre WebUI-server, f.eks. et hjemmelaboratorium eller en teamudrulning. Appen kontrollerer den før forbindelsen.

Valget gemmes. Skift server senere med Libre WebUI → Skift server… i menulinjen. Hvis en gemt server holder op med at svare, vender appen tilbage til velkomstskærmen i stedet for et tomt vindue.

Kør en lokal server efter Hurtig start: Docker Compose, npx libre-webui og Homebrew fungerer alle.

🧰 Work i skrivebordsappen​

Skrivebordspakken indeholder ikke backend, Docker eller en Work-containerruntime. Work-tilgængeligheden bestemmes af serveren:

  • en integreret backend, der kan køre docker info, kan oprette opgaveafgrænsede Work-containere og navngivne volumener;
  • repositoryts standard-Compose-udrulning leverer Docker-baseret Work ved at montere værtens Docker-socket, mens en tilpasset containerudrulning uden tilgængelig runtime rapporterer Work som utilgængelig;
  • en Kubernetes-server leverer Pod-/PVC-baseret Work, når Helm-diagrammet installeres med work.enabled=true; og
  • appen understøtter fortsat Chat, når Work ikke er tilgængelig.

Work-filer findes på serverens Docker-vært eller Kubernetes-lager, ikke i skrivebordsappen. Forhåndsvisninger går gennem Libre WebUI's signerede same-origin-proxy, så lokale og fjernklienter kan bruge dem, når serverens reverse proxy bevarer HTTP- og WebSocket-trafik.

🎨 Skrivebordsintegration​

  • Integreret menulinje med menuer til program, redigering, visning, vindue og hjælp
  • Tilpasset macOS-titellinje (hiddenInset) med trafiklys i sidepanelet
  • Mørk tilstand følger systemindstillingen
  • Eksterne links åbnes i standardbrowseren, aldrig i appen
  • Rendereren kører med kontekstisolering og uden Node-integration

🚧 Begrænsninger​

  • macOS-arkitektur: aktuelle macOS-pakker understøtter kun Apple Silicon (arm64)
  • Kræver en server: appen indeholder ikke backend
  • Work afhænger af serverens runtime: ingen Docker- eller Kubernetes-runtime medfølger
  • Ingen automatiske opdateringer: opdatering kræver en ny pakke

Se Work: Isolerede arbejdsområder for sikkerhedsoplysninger om runtime, udbydere, lager og forhåndsvisning.