Passa al contenuto principale

Docker con Ollama esterno

Usa questa configurazione quando Ollama è già in esecuzione sull'host, su un altro server o su un computer Tailscale/LAN.

Disponibilità di Work​

Questa configurazione cambia la posizione di Ollama; Work resta attivo tramite il socket Docker dell'host. Concede a Libre WebUI un controllo equivalente a root, quindi usala solo se gli amministratori di Libre WebUI sono anche amministratori affidabili dell'host. Su Linux imposta DOCKER_GID nel .env sul gruppo del socket. Rimuovi il mount se non vuoi Work. Vedi Work: spazi di lavoro isolati.

Prerequisiti​

curl http://localhost:11434/api/version

Per un'istanza nuova:

ollama pull gemma4:12b

Avviare Libre WebUI​

docker compose -f docker-compose.external-ollama.yml up -d

Apri http://localhost:8080.

Per impostazione predefinita, Compose punta OLLAMA_BASE_URL a http://host.docker.internal:11434.

URL Ollama personalizzato​

OLLAMA_BASE_URL=http://192.168.1.100:11434 docker compose -f docker-compose.external-ollama.yml up -d

Sugli host Linux che non risolvono host.docker.internal:

extra_hosts:
  - 'host.docker.internal:host-gateway'

Persistenza dei dati​

I dati sono nei volumi:

  • libre_webui_data
  • libre_webui_temp

Imposta segreti stabili:

JWT_SECRET=replace-with-a-long-random-secret
ENCRYPTION_KEY=replace-with-64-hex-characters

Esegui il backup congiunto del volume e della chiave.

Accesso alla rete​

Il file Compose imposta CORS_ORIGIN direttamente; un valore nel shell o .env non sostituisce il letterale. Modifica libre-webui.environment o aggiungi un override come compose.origin.yml:

services:
  libre-webui:
    environment:
      CORS_ORIGIN: http://localhost:8080,http://192.168.1.50:8080
      BASE_URL: http://192.168.1.50:8080

Applica entrambi:

docker compose \
  -f docker-compose.external-ollama.yml \
  -f compose.origin.yml \
  up -d

Per un dominio pubblico usa l'origine HTTPS esatta per entrambi e termina il traffico con HTTPS.

Comandi utili​

docker compose -f docker-compose.external-ollama.yml ps
docker compose -f docker-compose.external-ollama.yml logs -f libre-webui
docker compose -f docker-compose.external-ollama.yml restart
docker compose -f docker-compose.external-ollama.yml pull
docker compose -f docker-compose.external-ollama.yml up -d

Risoluzione dei problemi​

Libre WebUI non raggiunge Ollama

docker compose -f docker-compose.external-ollama.yml exec libre-webui \
  wget -O- http://host.docker.internal:11434/api/version

Se non funziona, usa un IP LAN/Tailscale esplicito in OLLAMA_BASE_URL.

I modelli non compaiono

ollama list

Il gestore legge dall'istanza configurata.

Errori CORS

CORS_ORIGIN deve coincidere esattamente con origine, schema e porta del browser.

Documenti correlati​