Pular para o conteúdo principal

Docker com Ollama externo

Use esta configuração quando o Ollama já estiver no host, em outro servidor ou em uma máquina Tailscale/LAN.

Disponibilidade do Work​

Essa configuração muda onde o Ollama roda; Work continua ativado pelo socket Docker do host. Isso dá ao Libre WebUI controle equivalente a root, portanto use somente onde seus administradores também sejam administradores confiáveis do host. No Linux, defina DOCKER_GID no .env como o grupo do socket. Remova a montagem se não quiser Work. Consulte Work: espaços de trabalho isolados.

Pré-requisitos​

Confirme que o Ollama está acessível:

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

Baixe um modelo se a instância for nova:

ollama pull gemma4:12b

Iniciar o Libre WebUI​

Na raiz do repositório:

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

Abra http://localhost:8080.

Por padrão, o Compose aponta OLLAMA_BASE_URL para http://host.docker.internal:11434.

URL Ollama personalizada​

Para outro host:

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

Em hosts Linux que não resolvem host.docker.internal, adicione ao serviço:

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

Persistência​

O Compose armazena dados em:

  • libre_webui_data
  • libre_webui_temp

Defina segredos estáveis em produção:

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

Faça backup conjunto do volume e da chave.

Acesso à rede​

O arquivo Compose define CORS_ORIGIN diretamente; valores do shell ou .env não substituem esse literal. Edite libre-webui.environment ou adicione uma substituição, como 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

Aplique os dois:

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

Para domínio público, use a origem HTTPS exata em ambos e termine o tráfego com HTTPS.

Comandos úteis​

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

Solução de problemas​

Libre WebUI não alcança o Ollama

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

Se falhar, use um IP LAN/Tailscale explícito em OLLAMA_BASE_URL.

Modelos não aparecem

Confira o host Ollama:

ollama list

O gerenciador lê da instância configurada.

Erros de CORS

Garanta que CORS_ORIGIN coincida com a origem exata do navegador, incluindo esquema e porta.

Documentos relacionados​