Avvio rapido
Requisiti
| Requisito | Minimo | Consigliato |
|---|---|---|
| Node.js | 22.22+ | Ultima versione LTS |
| RAM | 8 GB | 16 GB+ |
| Disco | 5 GB | 20 GB+ per i modelli |
| GPU | Opzionale | 8 GB+ di VRAM per un'inferenza locale rapida |
| Docker | Opzionale | Necessario per le attività Work |
Libre WebUI funziona con Ollama anche usando soltanto la CPU, ma in questo caso i modelli più piccoli sono più adatti. Per i plugin dei provider cloud serve solo la relativa chiave API.
Chat, documenti, artefatti e funzionalità basate sui provider non richiedono Docker.
Work invece sì: Docker deve essere installato sulla macchina che esegue il backend
di Libre WebUI e il processo del backend deve avere il permesso di avviarlo. Il comando
npx libre-webui non installa Docker. Se Docker non è disponibile, il resto di Libre
WebUI continua a funzionare, mentre Work segnala Runtime non disponibile; come
soluzione alternativa, i comandi del modello non vengono mai eseguiti direttamente sull'host.
Avviare Libre WebUI
npx libre-webui@latest
Apri http://localhost:8080. Crea il primo account,
che diventerà l'amministratore. In seguito, la registrazione pubblica rimane
disabilitata, a meno che non imposti esplicitamente ENABLE_SIGNUP=true.
Il programma di avvio incluso conserva lo stato persistente in ~/.libre-webui. Imposta
un percorso assoluto in DATA_DIR per scegliere un'altra posizione; i valori relativi
vengono risolti a partire dalla directory in cui esegui npx.
Installare Ollama
Installa Ollama, quindi scarica un piccolo modello generico:
ollama pull gemma4:12b
Altre ottime opzioni sono gemma4:26b (MoE), gemma4:31b (dense) e qwen3.8:27b. Usa il Gestore modelli di Libre WebUI per sfogliare i modelli installati, cercare nella libreria Ollama aggiornata e scaricare modelli senza uscire dall'app.
Per la ricerca semantica nei documenti, installa anche un modello di embedding:
ollama pull nomic-embed-text
Aggiungere provider cloud
I provider cloud sono facoltativi. Aggiungi le chiavi per singolo utente in Impostazioni → Chiavi API
oppure per tutto il server in backend/.env (riavvia poi il backend), quindi abilita il
provider nelle Impostazioni:
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=sk-or-...
KIMI_API_KEY=...
Quando possibile, l'app aggiorna gli elenchi dei modelli dei provider. Non è necessario tenere aperta la documentazione per trovare i nomi dei modelli più recenti.
Avviare la prima attività Work
Work assegna a ogni attività una conversazione persistente e un file system separato, basato su container. È disponibile agli amministratori autenticati.
- Installa e avvia Docker sulla macchina che esegue il backend di Libre WebUI.
- Avvia un'attività dal pulsante Work nell'intestazione della barra laterale, dal menu
+della barra delle schede, dalla pagina Home oppure conCmd/Ctrl + Shift + U. - Scegli un modello che supporti la chiamata di strumenti.
- Descrivi ciò che vuoi creare o modificare, quindi seleziona Esegui.
- Segui il risultato nelle schede File, Attività, Git, Terminale e Anteprima del pannello dell'area di lavoro.
L'attività rimane nella barra laterale, così puoi tornare in seguito alla stessa conversazione e agli stessi file. L'arresto di un'esecuzione o di un'anteprima conserva l'area di lavoro. L'eliminazione dell'attività elimina definitivamente la relativa area di lavoro.
Work può usare un modello Ollama installato, un modello Ollama Cloud oppure un plugin configurato per provider di chat o completamento. Quando selezioni un provider remoto, Libre WebUI mostra un'informativa prima dell'esecuzione: il provider riceve la conversazione, le definizioni degli strumenti ed eventuali risultati degli strumenti richiesti dal modello. Un'esecuzione autonoma può effettuare più chiamate a pagamento al provider.
Consulta Work: aree di lavoro isolate per i dettagli su runtime, persistenza, rete, anteprima e sicurezza.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
Crea il primo amministratore nel browser. Non sono necessari flag di registrazione né riavvii; le registrazioni pubbliche successive sono chiuse per impostazione predefinita.
Se Ollama è già in esecuzione sull'host o su un'altra macchina:
docker compose -f docker-compose.external-ollama.yml up -d
Per l'accelerazione con GPU NVIDIA, usa il file Compose per GPU incluso nel repository.
I file Compose del repository montano il socket Docker dell'host, così Work è disponibile quando
Docker è installato. Ciò conferisce all'applicazione un controllo dell'host equivalente a quello di root,
quindi leggi prima Work: aree di lavoro isolate. Su Linux, imposta
DOCKER_GID in .env sul gruppo proprietario del socket. Rimuovi il mount se
non vuoi usare Work.
Anche Ollama incluso è accessibile solo internamente. Aggiungi
-f docker-compose.ollama-host.yml solo quando un altro processo host deve accedere alla sua API;
l'override si associa all'interfaccia di loopback per impostazione predefinita.
Orientarsi nell'interfaccia
La scheda Home comprende tre sezioni: Inizia (nuova chat, chat in incognito, nuova
attività Work), Continua (conversazioni e attività recenti) ed Esplora
(Note, Calendario, Automazioni, Modelli, Personaggi, Immagina). Le stesse
destinazioni si trovano nella riga di navigazione della barra laterale e nella tavolozza dei comandi
(Cmd/Ctrl + K), che esegue una ricerca approssimativa tra chat, attività Work e azioni
dell'app, oltre a una ricerca testuale completa nei contenuti di messaggi, note e documenti.
- Calendario — un calendario per utente con eventi ricorrenti.
- Automazioni — esecuzioni AI pianificate recapitate come sessioni di chat.
Scorciatoie da tastiera
| Scorciatoia | Azione |
|---|---|
Cmd/Ctrl + K | Tavolozza dei comandi (funziona mentre scrivi) |
Cmd/Ctrl + Shift + O | Nuova chat |
Cmd/Ctrl + Shift + U | Nuova attività Work |
Cmd/Ctrl + B | Mostra/nasconde la barra laterale |
Cmd/Ctrl + , | Impostazioni |
Cmd/Ctrl + D | Cambia tema |
? | Apre Impostazioni nella scheda Scorciatoie |
Esc | Chiude la finestra delle impostazioni |
Enter | Invia il messaggio |
Shift + Enter | Nuova riga |