Passa al contenuto principale

🖥️ Applicazione desktop

L'app desktop Libre WebUI racchiude l'interfaccia web in una finestra nativa per macOS, Windows e Linux. Si collega a un server Libre WebUI in esecuzione sullo stesso computer oppure a qualsiasi server indicato dall'utente.

L'app viene sviluppata in un repository dedicato; gli installer di ogni versione sono allegati alle release GitHub del repository principale.

📦 Download e installazione​

Scarica il pacchetto per la tua piattaforma dall'ultima release:

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

Le versioni precedenti alla rinomina pubblicavano questi file con il prefisso Libre-WebUI-Frontend e un bundle chiamato Libre WebUI Frontend.app.

macOS segnala l'app come danneggiata​

Libre WebUI usa temporaneamente una firma ad hoc per le build macOS. La firma mantiene strutturalmente valido il bundle, ma non identifica l'editore presso Apple e non consente la notarizzazione. Dopo aver copiato l'app in Applicazioni, autorizzala in Impostazioni di Sistema → Privacy e sicurezza → Apri comunque.

Se macOS non mostra questa opzione, rimuovi l'attributo di quarantena soltanto dopo aver verificato che l'app provenga dalla release ufficiale di Libre WebUI:

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

Non disabilitare Gatekeeper globalmente. Una distribuzione senza interruzioni richiede ancora un certificato Developer ID Application e la notarizzazione Apple.

🔌 Connessione a un server​

L'app è un client e richiede un server Libre WebUI. Al primo avvio, la schermata iniziale offre due possibilità:

  • Locale: l'app cerca un server sul computer (porta 3001, predefinita per l'immagine Docker e npx libre-webui) e si collega quando il controllo di stato risponde.
  • Remoto: inserisci l'URL di un server Libre WebUI raggiungibile, come una distribuzione homelab o per team. L'app lo verifica prima di collegarsi.

La scelta viene ricordata. Per cambiare server in seguito usa Libre WebUI → Cambia server… nella barra dei menu. Se un server memorizzato smette di rispondere, l'app torna alla schermata iniziale invece di mostrare una finestra vuota.

Per avviare un server locale consulta Avvio rapido: sono supportati Docker Compose, npx libre-webui e Homebrew.

🧰 Work nell'app desktop​

Il pacchetto desktop non include backend, Docker o un runtime per container Work. La disponibilità di Work dipende dal server collegato:

  • un backend nativo che può eseguire docker info può creare container Work e volumi con nome limitati alle attività;
  • la distribuzione Compose standard del repository offre Work tramite Docker montando il socket del host, mentre una distribuzione container personalizzata senza runtime raggiungibile segnala Work come non disponibile;
  • un server Kubernetes offre Work basato su Pod/PVC quando il chart Helm è installato con work.enabled=true;
  • l'app continua a supportare Chat quando Work non è disponibile.

I file Work risiedono sul host Docker o nello storage Kubernetes del server, non dentro l'app desktop. Le anteprime passano attraverso il proxy firmato e same-origin di Libre WebUI; i client desktop locali e remoti possono quindi usarle quando il reverse proxy del server conserva il traffico HTTP e WebSocket.

🎨 Integrazione desktop​

  • Barra dei menu nativa con menu dell'app, modifica, vista, finestra e aiuto
  • Barra del titolo macOS personalizzata (hiddenInset) con i controlli nella barra laterale
  • La modalità scura segue la preferenza di sistema
  • I link esterni si aprono nel browser predefinito, mai dentro l'app
  • Il renderer usa l'isolamento del contesto senza integrazione Node

🚧 Limitazioni​

  • Architettura macOS: i pacchetti macOS attuali supportano solo Apple Silicon (arm64)
  • Richiede un server: l'app non include il backend
  • Work dipende dal runtime del server: non è incluso alcun runtime Docker o Kubernetes
  • Nessun aggiornamento automatico: per aggiornare occorre scaricare un nuovo pacchetto

Consulta Work: spazi isolati per i dettagli su runtime, provider, archiviazione e sicurezza delle anteprime.