~/ / Articoli sull'IA / LLM locali su un VPS / Open WebUI su una VPS: eseguirlo in Docker e collegarlo a Ollama
Open WebUI su una VPS: eseguirlo in Docker e collegarlo a Ollama
Una finestra di chat nel browser è il modo più semplice per usare un modello che gira sul tuo server. Open WebUI è una di queste interfacce, e la sua documentazione mostra come avviarlo con Docker e come collegarlo a Ollama. Questo articolo segue la guida rapida ufficiale e le guide di connessione, passo per passo, e segnala dove le due guide descrivono la connessione in modo diverso.
Pubblicato: · 4 min di lettura · Verificato sulla documentazione ufficiale di Open WebUI il 2026-10-26. Comandi, tag delle immagini e impostazioni cambiano da una versione all'altra, quindi controllali nei documenti aggiornati prima di eseguire qualsiasi cosa su un server.
Controlla prima la memoria
Open WebUI è un programma in più sullo stesso server, e la documentazione non indica alcun valore di memoria per esso. Secondo la guida rapida, l'immagine standard, con tag main, include modelli integrati di riconoscimento vocale e di embedding. Stima prima la memoria del tuo modello e lascia spazio per l'interfaccia e per il sistema operativo.
Provalo: Local LLM Memory Estimator
Stima
- Pesi del modello
- 4.84 GiB
- Cache KV
- 0.56 GiB
- Riserva
- 1.00 GiB
- Totale
- 6.41 GiB (6.88 GB)
- Più piccola dimensione di memoria comune che lo contiene
- 8 GiB
Questa è una stima. Non include i buffer di calcolo del runtime e presuppone che ogni layer abbia la stessa forma KV. Misura un'esecuzione reale prima di scegliere un piano.
Dati del modello verificati il 2026-10-26.
Fonti: Ollama library · Configurazione del modello (config.json) · Ollama FAQ
Tutto viene eseguito nel tuo browser. Non viene caricato nulla.
Avviarlo con Docker
La guida rapida serve Open WebUI su http://localhost:3000 e lo esegue con un solo comando docker run. Sostituisci your-secret-key con un valore che generi tu, per esempio con il comando che la guida indica a questo scopo.
| Passo | Comando |
|---|---|
| Generare una chiave segreta | openssl rand -hex 32 |
| Avviare Open WebUI | docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY=your-secret-key --name open-webui --restart always ghcr.io/open-webui/open-webui:main |
| Seguire i log | docker logs -f open-webui |
- -p 3000:8080 collega la porta 3000 dell'host alla porta 8080 del container.
- Il volume open-webui contiene le tue chat, gli utenti e le impostazioni. La guida dice che sopravvive agli aggiornamenti e che non bisogna mai eseguire il container senza di esso.
- WEBUI_SECRET_KEY: la guida dice di impostarla una volta sola e di conservarla, perché senza una chiave fissa ogni container ricreato disconnette tutti, e una nuova chiave disconnette tutti.
- I tag dell'immagine: main è l'immagine standard, cuda aggiunge il supporto alle GPU NVIDIA e richiede --gpus all, e ollama include Ollama nello stesso container.
Il primo account è l'amministratore
La prima schermata propone di creare un account admin. Secondo la guida, quel primo account è l'amministratore, che gestisce gli utenti e tutte le impostazioni dell'intera istanza, e la registrazione si disattiva da sola una volta che l'account admin esiste.
Nostra raccomandazione, non un'affermazione dei documenti: crea l'account admin subito dopo l'avvio del container, prima di comunicare l'indirizzo a qualcuno, perché chiunque raggiunga la pagina per primo può crearlo.
Collegarlo a Ollama: due modi nella documentazione
Le pagine di Open WebUI che abbiamo consultato descrivono la connessione in due modi diversi. Usa la pagina che corrisponde alla versione che esegui e verifica quale tipo offre la tua versione in Impostazioni, Admin, Connessioni.
| Connessione | Cosa dice la pagina |
|---|---|
| Protocollo Ollama API | In Impostazioni > Admin > Connessioni, Gestisci connessioni Ollama API. La pagina indica la porta 11434 come porta tipica e dice di usare http://host.docker.internal:11434 quando Open WebUI gira in Docker e Ollama gira sull'host. |
| Connessione di tipo OpenAI | Aggiungi una connessione di tipo OpenAI con l'URL di base http://localhost:11434/v1 e un testo qualsiasi come chiave API. La pagina dice che Ollama non controlla la chiave, ma che il campo non può essere vuoto, e che scrivere ollama funziona. |
- I modelli scaricati vengono rilevati automaticamente e compaiono nel selettore dei modelli. Puoi limitarli con un elenco separato da virgole.
- Puoi aggiungere più istanze di Ollama. La pagina dice che le richieste vengono distribuite con una selezione casuale, che gli ID dei modelli devono coincidere esattamente tra le istanze, e che un prefisso come remote/ permette di distinguere le istanze con gli stessi nomi di modello.
- Per un endpoint lento o irraggiungibile, la pagina suggerisce di impostare AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST=3 (il valore predefinito è 10 secondi) per un failover più rapido.
- Se la connessione fallisce, la pagina indica come causa più comune una configurazione errata della rete e rimanda alla propria guida alla risoluzione dei problemi.
Le pagine che abbiamo consultato non dicono se un container possa raggiungere un Ollama in ascolto solo su 127.0.0.1, e non trattano l'ampliamento dell'indirizzo di Ollama. Secondo le sue FAQ, Ollama per impostazione predefinita si lega a 127.0.0.1. Nostra raccomandazione: non aprire Ollama all'intera rete senza una regola del firewall che lo limiti agli indirizzi che usi.
Aggiornare e rimuovere
| Operazione | Comandi della guida rapida |
|---|---|
| Aggiornare a mano | docker rm -f open-webui, poi docker pull ghcr.io/open-webui/open-webui:main, poi lo stesso comando docker run di prima |
| Aggiornare con Watchtower | docker run --rm --volume /var/run/docker.sock:/var/run/docker.sock nickfedor/watchtower --run-once open-webui |
| Disinstallare | docker rm -f open-webui, poi docker rmi ghcr.io/open-webui/open-webui:main, poi docker volume rm open-webui |
Rimuovere il volume elimina le tue chat, gli utenti e le impostazioni. La guida dice che i tuoi dati si trovano nel volume, quindi conservalo quando aggiorni.
Mantenerlo privato
- La guida rapida mostra una variante con WEBUI_AUTH=False. Nostra raccomandazione, non un'affermazione dei documenti: non usarla su un server raggiungibile da chiunque.
- Metti HTTPS e una regola del firewall davanti alla porta 3000 prima di condividere l'indirizzo, e tieni la chiave segreta fuori da tutto ciò che committi.
- La guida rapida mostra anche come puntare Open WebUI a un altro server con OLLAMA_BASE_URL. In tal caso, considera anche quella connessione parte della tua rete privata.
Fonti
Leggi anche
- Mettere nginx davanti a Ollama: autenticazione basic, HTTPS e impostazioni per lo streamingRaggiungere Ollama dall'esterno in modo sicuro: nginx come proxy, autenticazione basic, HTTPS, impostazioni di streaming e timeout e una regola del firewall, dalla documentazione ufficiale.
- Chiamare un modello locale dal proprio codice: structured outputs e API compatibile con OpenAI in OllamaVincola l'output di un modello locale con un JSON Schema e chiama Ollama da client in stile OpenAI: cosa dice la documentazione ufficiale e cosa non è supportato.
- Cosa sa fare un modello locale? Tools, thinking, vision ed embedding in Ollama, e cosa entra in una VPSTools, thinking, vision, embedding: cosa significano le etichette della libreria di Ollama, quali modelli le portano e quanto pesano i download.
- Installare Ollama su un VPS e tenerlo in funzione: installazione, servizio systemd, impostazioni e aggiornamentiInstallare Ollama su un VPS Linux e tenerlo in funzione: il comando di installazione, il servizio systemd, le variabili d'ambiente, la cartella dei modelli e gli aggiornamenti, dalla documentazione ufficiale.