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

Hogyan telepítsük az Open WebUI-t a QNAP NAS-ra és csatlakoztassuk az Ollamához

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.

Nyissa meg az SSH-t vagy a File Station-t a QNAP NAS-on. Hozzon létre egy könyvtárat az Open WebUI tartós adatai számára:
/share/Container/open-webui

Ez a könyvtár tárolja a csevegési előzményeket, a felhasználói beállításokat és a konfigurációs adatokat. E kötet csatolása nélkül minden beszélgetése eltűnik, amikor a konténer újraindul.

A Container Station-ben hozzon létre egy új alkalmazást a következő tartalommal:

verzió: '3.8'
szolgáltatások:
  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

hálózatok:
  ai-network:
    name: ai-network
    driver: bridge

Fő konfiguráció magyarázata

• Kép:ghcr.io/open-webui/open-webui:main — Hivatalos Open WebUI kép a GitHub Container Registry-ből
• Port:3000:8080 — Böngészőből elérhető a http://NAS-IP:3000 címen, a konténer 8080-as portjára irányítva
• Kötet:/share/Container/open-webui:/app/backend/data — Tartós Tárhely a csevegésekhez és beállításokhoz
• OLLAMA_BASE_URL:http://ollama:11434 — Meg kell egyeznie az Ollama konténer szolgáltatás nevével és portjával
• Hálózat:ai-network — Megosztott hídhálózat az Ollama konténerrel
• Újraindítás:unless-stopped — A konténer automatikusan újraindul a QNAP újraindítása után

Várjon 30-60 másodpercet, amíg a konténer elindul. Ellenőrizze a naplókat a Container Station-ben.

Nyissa meg a böngészőt, és navigáljon ide:
http://YOUR-NAS-IP:3000

Képernyőkép: Open WebUI bejelentkezési képernyő regisztrációs mezőkkel

Első hozzáféréskor az Open WebUI egy regisztrációs űrlapot jelenít meg. Töltse ki:

• Név: A megjelenítendő név
• Email: Egy email cím (nem szükséges, hogy érvényes legyen)
• Jelszó: Egy biztonságos jelszó a fiókodhoz

Az első létrehozott fiók automatikusan admin fiókká válik. Ezt a fiókot létre kell hoznod, mielőtt a felület feloldódik. Kattints Fiók létrehozása.

Bejelentkezés után az Open WebUI megjeleníti a modellválasztót. Ha már letöltöttél modelleket az Ollama-ban, azok automatikusan megjelennek itt. Ha nincs listázva modell:

1. Menj a admin Panel menübe
2. Válaszd ki Beállítás -> Modellek
3. Ellenőrizd az Ollama kapcsolatait és a modellek elérhetőségét.
4. Húzz le egy modellt közvetlenül az Open WebUI-ból, vagy térj vissza az Ollama-ba, hogy először lehúzz egyet

Válassz egy modellt a legördülő listából (pl. Gemma, Qwen, Deepseek).

Írj be egy üzenetet a szövegdobozba alul, és nyomd meg az Entert. Az Open WebUI elküldi az üzenetedet az Ollama-nak, amely feldolgozza azt a kiválasztott modell segítségével, és visszaküld egy választ. A felület tárolja a teljes beszélgetést a tartós kötetedben.

Képernyőkép: Open WebUI csevegőfelület egy mintabeszélgetéssel

Ha azt szeretnéd, hogy az Open WebUI csatlakozzon egy másik QNAP NAS-on vagy gépen futó Ollama-hoz (nem ugyanazon fizikai gazda), módosítsd a környezeti változót:
OLLAMA_BASE_URL: http://OTHER-NAS-IP:11434

Cseréld le OTHER-NAS-IP a távoli gép IP-címére, amelyen az Ollama fut. Biztosítsd, hogy a gép Tűzfal engedélyezze a 11434-es port forgalmát a QNAP NAS-odról. Mindkét gépnek ugyanazon a hálózaton kell lennie, vagy megfelelő útvonalvezetéssel kell rendelkeznie.