~/ / Artículos de IA / LLM locales en un VPS / Open WebUI en un VPS: ejecútalo en Docker y conéctalo a Ollama
Open WebUI en un VPS: ejecútalo en Docker y conéctalo a Ollama
Una ventana de chat en el navegador es la forma más sencilla de usar un modelo que se ejecuta en tu propio servidor. Open WebUI es una de esas interfaces, y su documentación muestra cómo iniciarla con Docker y cómo conectarla a Ollama. Este artículo sigue paso a paso la guía de inicio rápido oficial y las guías de conexión, e indica dónde las dos guías describen la conexión de manera distinta.
Publicado: · 5 min de lectura · Comprobado con la documentación oficial de Open WebUI el 2026-10-26. Los comandos, las etiquetas de imagen y los ajustes cambian entre versiones, así que confírmalos en los documentos actuales antes de ejecutar nada en un servidor.
Comprueba primero la memoria
Open WebUI es un programa adicional en el mismo servidor, y la documentación no da ninguna cifra de memoria para él. Según la guía de inicio rápido, la imagen estándar, con la etiqueta main, incluye modelos integrados de voz a texto y de embeddings. Estima primero la memoria de tu modelo y deja margen para la interfaz y el sistema operativo.
Pruébalo: Local LLM Memory Estimator
Estimación
- Pesos del modelo
- 4.84 GiB
- Caché KV
- 0.56 GiB
- Reserva
- 1.00 GiB
- Total
- 6.41 GiB (6.88 GB)
- Tamaño de memoria habitual más pequeño que lo contiene
- 8 GiB
Es una estimación. No incluye los búferes de cálculo del runtime y supone que todas las capas tienen la misma forma de KV. Mide una ejecución real antes de elegir un plan.
Datos del modelo comprobados el 2026-10-26.
Fuentes: Ollama library · Configuración del modelo (config.json) · Ollama FAQ
Todo se ejecuta en tu navegador. No se sube nada.
Iníciala con Docker
La guía de inicio rápido sirve Open WebUI en http://localhost:3000 y lo ejecuta con un único comando docker run. Sustituye your-secret-key por un valor que generes tú, por ejemplo con el comando que la guía da para ello.
| Paso | Comando |
|---|---|
| Generar una clave secreta | openssl rand -hex 32 |
| Iniciar Open WebUI | docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY=your-secret-key --name open-webui --restart always ghcr.io/open-webui/open-webui:main |
| Seguir los registros | docker logs -f open-webui |
- -p 3000:8080 asigna el puerto 3000 del host al puerto 8080 del contenedor.
- El volumen open-webui guarda tus chats, usuarios y ajustes. La guía dice que sobrevive a las actualizaciones y que nunca debes ejecutarlo sin él.
- WEBUI_SECRET_KEY: la guía dice que se defina una sola vez y se conserve, porque sin una clave fija cada contenedor que se vuelve a crear cierra la sesión de todos, y una clave nueva cierra la sesión de todos.
- Las etiquetas de imagen: main es la imagen estándar, cuda añade compatibilidad con GPU de NVIDIA y necesita --gpus all, y ollama incluye Ollama dentro del mismo contenedor.
La primera cuenta es la de administrador
La primera pantalla ofrece crear una cuenta de administrador. Según la guía, esa primera cuenta es la administradora: gestiona los usuarios y todos los ajustes de la instancia, y el registro se desactiva por sí solo en cuanto existe la cuenta de administrador.
Nuestra recomendación, no una afirmación de los documentos: crea la cuenta de administrador justo después de que arranque el contenedor, antes de dar la dirección a nadie, porque quien llegue primero a la página puede crearla.
Conéctalo a Ollama: dos formas en la documentación
Las páginas de Open WebUI que hemos comprobado describen la conexión de dos maneras distintas. Usa la página que corresponda a la versión que ejecutas y confirma qué tipo ofrece tu versión en Ajustes, Administración, Conexiones.
| Conexión | Qué dice la página |
|---|---|
| Protocolo de la API de Ollama | En Ajustes > Administración > Conexiones, Gestionar conexiones de la API de Ollama. La página da el puerto 11434 como puerto habitual, y dice que se use http://host.docker.internal:11434 cuando Open WebUI se ejecuta en Docker y Ollama se ejecuta en el host. |
| Conexión de tipo OpenAI | Añade una conexión de tipo OpenAI con la URL base http://localhost:11434/v1 y cualquier texto como clave de API. La página dice que Ollama no comprueba la clave, pero que el campo no puede estar vacío, y que escribir ollama funciona. |
- Los modelos descargados se detectan automáticamente y aparecen en el selector de modelos. Puedes limitarlos con una lista separada por comas.
- Puedes añadir varias instancias de Ollama. La página dice que las solicitudes se reparten por selección aleatoria, que los ID de modelo deben coincidir exactamente entre instancias y que un prefijo como remote/ distingue las instancias que tienen los mismos nombres de modelo.
- Para un endpoint lento o inaccesible, la página sugiere definir AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST=3 (el valor por defecto es 10 segundos) para una conmutación por error más rápida.
- Si la conexión falla, la página señala la configuración incorrecta de la red como la causa más habitual y remite a su guía de solución de problemas.
Las páginas que hemos comprobado no dicen si un contenedor puede acceder a un Ollama que escucha solo en 127.0.0.1, y tampoco tratan cómo ampliar la dirección de Ollama. Según sus preguntas frecuentes, Ollama se enlaza a 127.0.0.1 por defecto. Nuestra recomendación: no abras Ollama a toda la red sin una regla de cortafuegos que lo limite a las direcciones que usas.
Actualizar y eliminar
| Tarea | Comandos de la guía de inicio rápido |
|---|---|
| Actualizar a mano | docker rm -f open-webui, después docker pull ghcr.io/open-webui/open-webui:main, después el mismo comando docker run de antes |
| Actualizar con Watchtower | docker run --rm --volume /var/run/docker.sock:/var/run/docker.sock nickfedor/watchtower --run-once open-webui |
| Desinstalar | docker rm -f open-webui, después docker rmi ghcr.io/open-webui/open-webui:main, después docker volume rm open-webui |
Eliminar el volumen borra tus chats, usuarios y ajustes. La guía dice que tus datos están en el volumen, así que consérvalo cuando actualices.
Mantenlo privado
- La guía de inicio rápido muestra una variante con WEBUI_AUTH=False. Nuestra recomendación, no una afirmación de los documentos: no la uses en un servidor al que pueda acceder cualquiera.
- Coloca HTTPS y una regla de cortafuegos delante del puerto 3000 antes de compartir la dirección, y mantén la clave secreta fuera de todo lo que subas a un repositorio.
- La guía de inicio rápido también muestra cómo apuntar Open WebUI a otro servidor con OLLAMA_BASE_URL. Si lo haces, trata esa conexión también como parte de tu red privada.
Fuentes
Sigue leyendo
- Poner nginx delante de Ollama: autenticación básica, HTTPS y ajustes para el streamingAcceder a Ollama desde fuera de forma segura: nginx como proxy, autenticación básica, HTTPS, ajustes de streaming y de tiempo de espera, y una regla de cortafuegos, según la documentación oficial.
- Llamar a un modelo local desde tu código: salidas estructuradas y la API compatible con OpenAI en OllamaLimita la salida de un modelo local con un JSON Schema y llama a Ollama desde clientes al estilo OpenAI: qué dice la documentación oficial y qué no se admite.
- ¿Qué puede hacer un modelo local? Tools, thinking, vision y embeddings en Ollama, y qué cabe en un VPSTools, thinking, vision, embeddings: qué significan las etiquetas de la biblioteca de Ollama, qué modelos las llevan y cuánto pesan las descargas.
- Instalar Ollama en un VPS y mantenerlo en marcha: instalación, servicio systemd, ajustes y actualizacionesInstala Ollama en un VPS con Linux y mantenlo en marcha: el comando de instalación, el servicio systemd, las variables de entorno, el almacenamiento de modelos y las actualizaciones, según la documentación oficial.