Open WebUI troubleshooting y producción ligera
Open WebUI es comodísimo para usar modelos locales, pero cuando lo conviertes en herramienta diaria necesitas pensar en versiones, volúmenes, backups, cambios de UI, conexión con Ollama y recuperación.
Objetivos de aprendizaje
- Evitar perder chats, usuarios o configuración por un mal update.
- Diagnosticar conexión con Ollama y problemas de herramientas.
- Preparar una instalación ligera para uso de pyme o equipo pequeño.
En cristiano: volumen Docker. Es donde vive tu estado persistente: base de datos, configuración, usuarios y archivos. Si lo borras, tu contenedor arranca “nuevo”.
Terminal
# Ver contenedores y logs docker ps docker logs -f open-webui # Comprobar Ollama desde el host curl http://localhost:11434/api/tags # Comprobar desde un contenedor en la misma red docker exec -it open-webui sh curl http://host.docker.internal:11434/api/tags
Idea clave. En Docker, `localhost` dentro del contenedor no es tu ordenador: es el propio contenedor. Muchos fallos de conexión con Ollama vienen de ahí.
Checklist antes de actualizar
- Apunta versión actual de la imagen.
- Haz backup del volumen de Open WebUI.
- Lee notas de release si dependes de tools, auth o RAG.
- Prueba en una copia si lo usa más gente.
- Ten un plan de rollback.
Terminal
# Backup simple de volumen Docker docker run --rm \ -v open-webui:/data \ -v "$PWD/backups":/backup \ alpine tar czf /backup/open-webui-$(date +%Y%m%d).tgz -C /data .
Cuidado. Si usas Open WebUI para documentos internos, no mezcles permisos “de juguete” con datos reales. Define usuarios, backups, políticas de retención y quién puede subir documentos.
Producción ligera mínima
- Open WebUI con volumen persistente.
- Ollama separado y monitorizado.
- Qdrant con volumen propio si haces RAG.
- Reverse proxy con HTTPS si sale de localhost.
- Backups probados, no solo configurados.
Comprueba que funciona. Restaura un backup en una carpeta o máquina distinta. Si nunca has restaurado, no tienes backup; tienes una esperanza.
Guardar y reabrir el proyecto.
Open WebUI puede ser la puerta de entrada perfecta para una pyme, siempre que lo trates como sistema con estado y no como contenedor desechable.