# 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