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

Come distribuire Open WebUI sul NAS QNAP e connettersi 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.

Apri SSH o File Station sul tuo NAS QNAP. Crea una directory per i dati persistenti di Open WebUI:
/share/Container/open-webui

Questa directory memorizza la cronologia delle chat, le impostazioni utente e i dati di configurazione. Senza questo montaggio del volume, tutte le tue conversazioni scompaiono quando il container si riavvia.

In Container Station, crea una nuova Applicazione con il seguente contenuto:

versione: '3.8'
servizi:
  open-webui:
    immagine: ghcr.io/open-webui/open-webui:main
    nome_contenitore: open-webui
    porte:
      - "3000:8080"
    volumi:
      - /share/Container/open-webui:/app/backend/data
    ambiente:
      OLLAMA_BASE_URL: http://ollama:11434
    reti:
      - ai-network
    riavvio: unless-stopped

reti:
  ai-network:
    nome: ai-network
    driver: bridge

Spiegazione della Configurazione Chiave

• Immagine:ghcr.io/open-webui/open-webui:main — Immagine ufficiale di Open WebUI dal GitHub Container Registry
• Porta:3000:8080 — Accesso dal browser a http://NAS-IP:3000, mappato alla porta 8080 del contenitore
• Volume:/share/Container/open-webui:/app/backend/data — Archiviazione persistente per chat e impostazioni
• OLLAMA_BASE_URL:http://ollama:11434 — Deve corrispondere al nome del servizio e alla porta del tuo contenitore Ollama
• Rete:ai-network — Rete bridge condivisa con il contenitore Ollama
• Riavvio:unless-stopped — Il contenitore si riavvia automaticamente dopo il riavvio di QNAP

Attendere 30-60 secondi per l'avvio del contenitore. Controllare i log in Container Station.

Apri il browser e naviga a:
http://YOUR-NAS-IP:3000

Screenshot: Schermata di login di Open WebUI con campi di registrazione

Al primo accesso, Open WebUI visualizza un modulo di registrazione. Compila:

• Nome: Il tuo nome visualizzato
• Email: Un indirizzo email (non deve essere valido)
• Password: Una password sicura per il tuo account

Il primo account creato diventa automaticamente l'account admin. Devi creare questo account prima che l'interfaccia si sblocchi. Clicca su Crea Account.

Dopo l'accesso, Open WebUI mostra un selettore di modelli. Se hai già scaricato modelli in Ollama, appariranno qui automaticamente. Se non ci sono modelli elencati:

1. Vai al menu admin Pannello
2. Seleziona Impostazione -> Modelli
3. Verifica le connessioni di Ollama e visualizza la disponibilità dei modelli.
4. Scarica un modello direttamente da Open WebUI o torna a Ollama per scaricarne uno prima

Seleziona un modello dal menu a tendina (es., Gemma, Qwen, Deepseek).

Digita un messaggio nella casella di testo in basso e premi Invio. Open WebUI invia il tuo messaggio a Ollama, che lo elabora utilizzando il modello selezionato e restituisce una risposta. L'interfaccia memorizza l'intera conversazione nel tuo volume persistente.

Screenshot: Interfaccia chat di Open WebUI con una conversazione di esempio

Se desideri che Open WebUI si connetta a Ollama in esecuzione su un altro QNAP NAS o macchina (non lo stesso host fisico), modifica la variabile d'ambiente:
OLLAMA_BASE_URL: http://OTHER-NAS-IP:11434

Sostituisci OTHER-NAS-IP con l'indirizzo IP della macchina remota che esegue Ollama. Assicurati che il Firewall di quella macchina consenta il traffico sulla porta 11434 dal tuo QNAP NAS. Entrambe le macchine devono essere sulla stessa rete o avere un routing adeguato configurato.