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

如何在 QNAP NAS 上部署 Open WebUI 並連線到 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.

在您的 QNAP NAS 上開啟 SSH 或 File Station。為 Open WebUI 持久性資料建立目錄：
/share/Container/open-webui

此目錄存儲聊天記錄、用戶設定和配置資料。若沒有這個卷掛載，當容器重新啟動時，所有對話都會消失。

在 Container Station 中，建立一個新的應用程式，內容如下：

版本：'3.8'
服務：
  open-webui:
    映像：ghcr.io/open-webui/open-webui:main
    容器名稱：open-webui
    埠：
      - "3000:8080"
    卷：
      - /share/Container/open-webui:/app/backend/data
    環境：
      OLLAMA_BASE_URL: http://ollama:11434
    網路：
      - ai-network
    重啟：除非停止

網路：
  ai-network:
    名稱：ai-network
    驅動：橋接

關鍵配置說明

• 映像：ghcr.io/open-webui/open-webui:main — 來自 GitHub Container Registry 的官方 Open WebUI 映像
• 端口：3000:8080 — 從瀏覽器訪問http://NAS-IP:3000，映射到容器端口 8080
• 卷：/share/Container/open-webui:/app/backend/data — 聊天和設定的持久性儲存空間
• OLLAMA_BASE_URL:http://ollama:11434 — 必須與您的 Ollama 容器服務名稱和端口匹配
• 網路：ai-network — 與 Ollama 容器共享的橋接網路
• 重啟：unless-stopped — QNAP 重啟後容器自動重啟

等待 30-60 秒讓容器啟動。在 Container Station 中檢查日誌。

打開瀏覽器並導航至：
http://YOUR-NAS-IP:3000

截圖：Open WebUI 登入畫面，包含註冊欄位

首次訪問時，Open WebUI 顯示登錄檔單。填寫：

• 名稱：您的顯示名稱
• 電子郵件：電子郵件地址（不需要有效）
• 密碼:您帳戶的安全密碼

第一個建立的帳戶會自動成為 admin 帳戶。您必須在介面解鎖之前建立此帳戶。點擊建立帳戶。

登入後，Open WebUI 顯示型號選擇器。如果您已經在 Ollama 中拉取型號，它們會自動顯示在此處。如果沒有列出型號：

1. 前往admin 面板選單
2. 選擇設定 -> 型號
3. 驗證 Ollama 連線並顯示型號可用性。
4. 直接從 Open WebUI 拉取型號或返回 Ollama 先拉取一個

從下拉選單中選擇型號（例如，Gemma、Qwen、Deepseek）。

在底部的文字框中輸入訊息並按下 Enter。Open WebUI 將您的訊息傳送到 Ollama，使用選擇的型號處理並返回回應。介面將完整對話儲存在您的永續性儲存中。

螢幕截圖：Open WebUI 聊天介面及範例對話

如果您希望 Open WebUI 連接到在不同 QNAP NAS 或機器上運行的 Ollama（不是同一實體主機），請修改環境變數：
OLLAMA_BASE_URL: http://OTHER-NAS-IP:11434

將OTHER-NAS-IP替換為運行 Ollama 的遠端機器的 IP 位址。確保該機器的防火牆允許來自您的 QNAP NAS 的 11434 埠流量。兩台機器必須在同一網路上或已配置適當的路由。