Correções OpenWebUI — Troubleshooting
Problemas Comuns
OpenWebUI não conecta ao Ollama/llama.cpp
Sintoma: Interface carrega mas não consegue se comunicar com o backend Solução:
# Verificar se o container tem acesso ao host
docker run ... --add-host=host.docker.internal:host-gateway ...
# URL correta para llama.cpp rodando no host
http://host.docker.internal:8080
Container não inicia
Sintoma: docker run falha ou container para imediatamente
Solução:
# Ver logs do container
docker logs open-webui
# Remover container antigo e recriar
docker rm open-webui
docker run -d -p 3000:8080 ...
Porta 3000 já em uso
Sintoma: Erro "address already in use" ao iniciar container Solução:
# Usar porta alternativa
docker run -d -p 3001:8080 ...
# Acessar em localhost:3001
WSL2 não está ativo
Sintoma: Docker Desktop não inicia ou performance ruim Solução (PowerShell como Admin):
wsl --install
wsl --set-default-version 2
# Reiniciar o sistema
Resetar OpenWebUI (dados limpos)
docker stop open-webui
docker rm open-webui
docker volume rm open-webui
# Recriar o container do zero
Configuração Confirmada Funcionando
- OpenWebUI 0.9.5
- Docker Desktop com WSL2
- Backend: llama.cpp servidor na porta 8080