How to deploy Open WebUI on the QNAP NAS and connect to Ollama

Cómo implementar Open WebUI en el NAS de QNAP y conectarse a Ollama

Open SSH or File Station on your QNAP NAS. Create a directory for Open WebUI persistent data:
/share/Container/open-webui

This directory stores chat history, user settings, and configuration data. Without this volume mount, all your conversations disappear when the container restarts.

In Container Station, create a new Application with the following content:

version: '3.8'
services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    ports:
      - "3000:8080"
    volumes:
      - /share/Container/open-webui:/app/backend/data
    environment:
      OLLAMA_BASE_URL: http://ollama:11434
    networks:
      - ai-network
    restart: unless-stopped

networks:
  ai-network:
    name: ai-network
    driver: bridge

Key Configuration Explained

• Image:ghcr.io/open-webui/open-webui:main — Official Open WebUI image from GitHub Container Registry
• Port:3000:8080 — Access from browser at http://NAS-IP:3000, mapped to container port 8080
• Volume:/share/Container/open-webui:/app/backend/data — Persistent storage for chats and settings
• OLLAMA_BASE_URL:http://ollama:11434 — Must match your Ollama container service name and port
• Network:ai-network — Shared bridge network with Ollama container
• Restart:unless-stopped — Container restarts automatically after QNAP reboots

Wait 30-60 seconds for the container to start. Check logs in Container Station.

Open your browser and navigate to:
http://YOUR-NAS-IP:3000

Screenshot: Open WebUI login screen with sign-up fields

On first access, Open WebUI displays a sign-up form. Fill in:

• Name: Your display name
• Email: An email address (does not need to be valid)
• Password: A secure password for your account

The first account created automatically becomes the admin account. You must create this account before the interface unlocks. Click Create Account.

After signing in, Open WebUI shows a model selector. If you have already pulled models in Ollama, they appear here automatically. If no models are listed:

1. Go to the Admin Panel menu
2. Select Setting -> Models
3. Verify Ollama connections and display model availability.
4. Pull a model directly from Open WebUI or return to Ollama to pull one first

Select a model from the dropdown (e.g., Gemma, Qwen, Deepseek).

Type a message in the text box at the bottom and press Enter. Open WebUI sends your message to Ollama, which processes it using the selected model and returns a response. The interface stores the full conversation in your persistent volume.

Screenshot: Open WebUI chat interface with a sample conversation

If you want Open WebUI to connect to Ollama running on a different QNAP NAS or machine (not the same physical host), modify the environment variable:
OLLAMA_BASE_URL: http://OTHER-NAS-IP:11434

Replace OTHER-NAS-IP with the IP address of the remote machine running Ollama. Ensure that machine's firewall allows port 11434 traffic from your QNAP NAS. Both machines must be on the same network or have proper routing configured.

Abra SSH o File Station en su NAS de QNAP. Cree un directorio para los datos persistentes de Open WebUI:
/share/Container/open-webui

Este directorio almacena el historial de chat, la configuración del usuario y los datos de configuración. Sin este montaje de volumen, todas sus conversaciones desaparecerán cuando se reinicie el contenedor.

En Container Station, crea una nueva aplicación con el siguiente contenido:

version: '3.8'
services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    ports:
      - "3000:8080"
    volumes:
      - /share/Container/open-webui:/app/backend/data
    environment:
      OLLAMA_BASE_URL: http://ollama:11434
    networks:
      - ai-network
    restart: unless-stopped

networks:
  ai-network:
    name: ai-network
    driver: bridge

Explicación de la configuración clave

• Imagen:ghcr.io/open-webui/open-webui:main — Imagen oficial de Open WebUI desde GitHub Container Registry
• Puerto:3000:8080 — Acceso desde el navegador en http://NAS-IP:3000, mapeado al puerto 8080 del contenedor
• Volumen:/share/Container/open-webui:/app/backend/data — Almacenamiento persistente para chats y configuraciones
• OLLAMA_BASE_URL:http://ollama:11434 — Debe coincidir con el nombre y puerto del servicio de contenedor Ollama
• Red:ai-network — Red de puente compartida con el contenedor Ollama
• Reinicio:unless-stopped — El contenedor se reinicia automáticamente después de que QNAP se reinicie

Espera 30-60 segundos para que el contenedor se inicie. Revisa los registros en Container Station.

Abre tu navegador y navega a:
http://YOUR-NAS-IP:3000

Captura de pantalla: Pantalla de inicio de sesión de Open WebUI con campos de registro

En el primer acceso, Open WebUI muestra un formulario de registro. Completa:

• Nombre: Tu nombre para mostrar
• Correo electrónico: Una dirección de correo electrónico (no necesita ser válida)
• Contraseña: Una contraseña segura para su cuenta

La primera cuenta creada se convierte automáticamente en la cuenta admin. Debe crear esta cuenta antes de que la interfaz se desbloquee. Haga clic en Crear cuenta.

Después de iniciar sesión, Open WebUI muestra un selector de modelos. Si ya ha descargado modelos en Ollama, aparecen aquí automáticamente. Si no hay modelos listados:

1. Vaya al menú admin Panel
2. Seleccione Configuración -> Modelos
3. Verifique las conexiones de Ollama y muestre la disponibilidad de modelos.
4. Descargue un modelo directamente desde Open WebUI o regrese a Ollama para descargar uno primero

Seleccione un modelo del menú desplegable (por ejemplo, Gemma, Qwen, Deepseek).

Escriba un mensaje en el cuadro de texto en la parte inferior y presione Enter. Open WebUI envía su mensaje a Ollama, que lo procesa utilizando el modelo seleccionado y devuelve una respuesta. La interfaz almacena la conversación completa en su volumen persistente.

Captura de pantalla: interfaz de chat de Open WebUI con una conversación de muestra

Si desea que Open WebUI se conecte a Ollama que se ejecuta en un NAS de QNAP diferente o máquina (no el mismo host físico), modifique la variable de entorno:
OLLAMA_BASE_URL: http://OTHER-NAS-IP:11434

Reemplace OTHER-NAS-IP con la dirección IP de la máquina remota que ejecuta Ollama. Asegúrese de que el Firewall de esa máquina permita el tráfico del puerto 11434 desde su NAS de QNAP. Ambas máquinas deben estar en la misma red o tener una configuración de enrutamiento adecuada.