Tu propio Open WebUI: conecta modelos, gestiona cuentas y conserva las conversaciones

Si ya tienes claves de API de distintos modelos y quieres una interfaz web de chat para ti o para un equipo pequeño, Open WebUI es una de las opciones más sencillas en un solo contenedor: trae cuentas multiusuario, historial de conversaciones, subida de documentos y cambio de modelo listos para usar.

En esta guía usamos la plantilla de Open WebUI de Zenavo para desplegar la interfaz en tu propio servidor y conectarla a API de modelos externas. Si quieres compararla con una plataforma multiusuario que incluye PostgreSQL, Redis y almacenamiento S3 propio, echa un vistazo a nuestra guía de LobeHub.

La plantilla no incluye modelos locales ni inferencia por GPU; el servidor, Zenavo y las API de modelos se facturan por separado.

Despliega Open WebUI

Primero conecta un servidor Linux a Zenavo, abre la plantilla de Open WebUI, elige el servidor y despliega.

Actualmente la plantilla configura:

Ajuste	Valor o finalidad
Imagen	ghcr.io/open-webui/open-webui:main
Puerto HTTP	8080
Volumen	/app/backend/data: aquí están la base de datos SQLite, los documentos subidos y los ajustes
WEBUI_SECRET_KEY	Se genera al crear el proyecto y protege las sesiones de inicio de sesión
ENABLE_OLLAMA_API	false, desactiva por defecto la búsqueda de un Ollama local para usar directamente API externas
Variables de telemetría	SCARF_NO_ANALYTICS, DO_NOT_TRACK y ANONYMIZED_TELEMETRY vienen desactivadas
Memoria	Se recomienda reservar unos 2 GB

La etiqueta main sigue las versiones nuevas del proyecto. Para un uso estable a largo plazo, entra en Ajustes → Origen del servicio y fija la imagen en una versión concreta que hayas probado (como ghcr.io/open-webui/open-webui:v0.6.5).

Asocia un dominio y registra de inmediato la cuenta de administrador

En la pestaña Red del servicio open-webui, asocia un dominio como chat.example.com al puerto 8080, añade en el DNS un registro A que apunte al servidor y espera a que esté listo el HTTPS. Los pasos están en Dominios y HTTPS.

En cuanto funcione el dominio, abre la web y registra la primera cuenta. Open WebUI convierte en administrador al primer usuario que se registra; mientras no lo hagas tú, cualquiera que conozca la dirección podría adelantarse.

Una vez dentro, abre Panel de administración → Ajustes → General (Admin Panel → Settings → General) y revisa la política de registro de nuevos usuarios:

• Si es solo para ti: desactiva el registro de nuevos usuarios (Enable New Sign Ups);
• Si es para un equipo: deja el rol por defecto (Default User Role) en pending (pendiente) para que ninguna cuenta nueva pueda usar los modelos hasta que tú la apruebes.

Conecta las API de modelos

Abre Panel de administración → Ajustes → Conexiones (Connections), introduce la Base URL y la API Key de tu proveedor en el apartado de OpenAI API y guarda. Verás la lista de modelos en el selector de la esquina superior izquierda del chat.

Dos formas habituales de conectarlo:

• Directamente a un proveedor: pon la dirección compatible con OpenAI que te dé el proveedor (suele terminar en /v1; cuidado con no escribir /v1 dos veces) y su clave de API.
• A través de tu propia pasarela: si tienes desplegado New API, Magpie o LiteLLM, apunta la Base URL a tu pasarela para centralizar OpenAI, Anthropic, Gemini o DeepSeek con una sola clave y cuota. Si la pasarela está en el mismo proyecto de Zenavo que Open WebUI, puedes usar directamente la red privada (por ejemplo, http://new-api.zenavo.internal:3000/v1).
• Añade búsqueda web en vivo y bots de mensajería: para que los modelos consulten páginas web en tiempo real sin pagar por consulta, añade SearXNG al mismo proyecto; y si quieres hablar con tu asistente desde Telegram, Discord o Slack, combínalo con OpenClaw.

Si compartes la instancia con más personas, en Admin Panel → Settings → Models puedes elegir qué modelos ven los usuarios normales para evitar que usen por error los más caros.

Copias de seguridad y actualizaciones

Las cuentas, el historial de chat, los documentos y los ajustes de conexión se guardan en el volumen /app/backend/data. Además, la variable WEBUI_SECRET_KEY en la pestaña Variable del servicio protege las sesiones: no la cambies después de desplegar y guarda una copia en tu gestor de contraseñas.

Haz copia de seguridad del volumen desde la pestaña Copias de seguridad y restauración del servicio open-webui:

1. Elige una ventana de mantenimiento en la que nadie lo esté usando y detén el proyecto (la copia de un volumen requiere que el proyecto esté detenido).
2. Crea la copia de seguridad y vuelve a iniciar el proyecto cuando termine.
3. Descarga una copia para conservarla. Contiene conversaciones y claves de API, así que guárdala en un lugar seguro.

Los detalles están en Copias de seguridad y restauración. Antes de actualizar, haz copia de seguridad del volumen y lee las notas de la versión de Open WebUI antes de cambiar la etiqueta de la imagen. Si una actualización migra la base de datos interna y algo falla, restaurar la copia anterior es la forma segura de volver atrás.

Preguntas frecuentes

¿La lista de modelos sale vacía después de guardar la conexión? Comprueba que la Base URL termina como exige el proveedor (la mayoría de las API compatibles con OpenAI llevan /v1) y que la API Key es válida. Si el proveedor no ofrece el endpoint /v1/models, escribe a mano los ID de los modelos en los ajustes de la conexión.

¿Da error 401 o 404 al enviar un mensaje? Un 401 suele ser una API Key incorrecta, caducada o sin permisos para ese modelo; un 404 casi siempre significa que en la Base URL sobra /chat/completions o falta /v1.

¿He cambiado una variable de entorno y reiniciado, pero en la web sigue el valor anterior? Cuando Open WebUI guarda los ajustes de administración en su base de datos, esos valores tienen prioridad sobre las variables de entorno. Cámbialo directamente en Admin Panel → Settings y guarda.

¿Se puede conectar un Ollama local? Sí. La plantilla define ENABLE_OLLAMA_API=false por defecto para que no salgan errores cuando no hay ningún Ollama instalado. Si ejecutas Ollama en el mismo proyecto o red privada, cambia ENABLE_OLLAMA_API a true y añade OLLAMA_BASE_URL.

Empieza con la plantilla de Open WebUI: asocia primero el dominio, registra la cuenta de administrador, cierra o restringe el registro y después conecta tus modelos y configura las copias de seguridad.