Ana içeriğe geç

Harici Ollama ile Docker

Ollama ana bilgisayarınızda, başka bir sunucuda veya Tailscale/LAN makinesinde zaten çalışıyorsa bu yapılandırmayı kullanın.

Work Kullanılabilirliği​

Bu Compose yapısı Ollama’nın yerini değiştirir; Work, bağlanan ana bilgisayar Docker socket’iyle açık kalır. Bu Libre WebUI’ya ana bilgisayarda root düzeyinde denetim verir; yalnızca Libre WebUI yöneticilerinin güvenilir ana bilgisayar yöneticileri olduğu yerde kullanın. Linux’ta .env içindeki DOCKER_GID değerini socket’in grubuna ayarlayın. Work istenmiyorsa bağlantıyı kaldırın. Bkz. Work: yalıtılmış çalışma alanları.

Ön Koşullar​

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

Yeni örnek için model indirin:

ollama pull gemma4:12b

Libre WebUI’yı Başlatma​

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

http://localhost:8080 adresini açın. Compose, OLLAMA_BASE_URL değerini varsayılan olarak http://host.docker.internal:11434 yapar.

Özel Ollama URL’si​

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

host.docker.internal çözmeyen Linux için:

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

Veri Kalıcılığı​

  • libre_webui_data
  • libre_webui_temp

Üretimde kararlı sırlar kullanın:

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

Veri birimini ve şifreleme anahtarını birlikte yedekleyin.

Ağ Erişimi​

Depo Compose dosyası CORS_ORIGIN değerini doğrudan ayarlar; kabuk veya .env bunu değiştirmez. libre-webui.environment kaydını düzenleyin ya da compose.origin.yml gibi geçersiz kılma ekleyin:

services:
  libre-webui:
    environment:
      CORS_ORIGIN: http://localhost:8080,http://192.168.1.50:8080
      BASE_URL: http://192.168.1.50:8080
docker compose \
  -f docker-compose.external-ollama.yml \
  -f compose.origin.yml \
  up -d

Genel etki alanında iki değer için de tam HTTPS kökenini kullanın ve trafiği HTTPS ile sonlandırın.

Yararlı Komutlar​

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

Sorun Giderme​

Libre WebUI Ollama’ya ulaşamıyor

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

Başarısızsa OLLAMA_BASE_URL içinde açık LAN/Tailscale IP’si kullanın.

Modeller görünmüyor

ollama list

Model Yöneticisi yapılandırılmış Ollama’yı okur.

CORS hataları

CORS_ORIGIN değerinin şema ve port dâhil tarayıcı kökeniyle tam eşleştiğini doğrulayın.

İlgili Belgeler​