docs/markdown/OPENWEBUI.md

OpenWebUI

Versão

• 0.9.5

Backend Suportado

• Ollama
• llama.cpp (via API compatível)

Porta

• localhost:3000

Deploy via Docker (recomendado)

docker run -d \
  -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

Requisitos

• Docker Desktop instalado
• WSL2 ativo e configurado
• Windows 10/11 com virtualização habilitada

Observações

• Docker funcionou melhor que instalação nativa
• WSL2 necessário para performance adequada
• Conectar ao llama.cpp via http://host.docker.internal:8080

Troubleshooting

• Se não conectar ao Ollama: verificar --add-host=host.docker.internal:host-gateway
• Porta 3000 ocupada: trocar -p 3000:8080 para -p 3001:8080