| # 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:** | |
| ```bash | |
| # 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:** | |
| ```bash | |
| # 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:** | |
| ```bash | |
| # 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):** | |
| ```powershell | |
| wsl --install | |
| wsl --set-default-version 2 | |
| # Reiniciar o sistema | |
| ``` | |
| ### Resetar OpenWebUI (dados limpos) | |
| ```bash | |
| 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 | |