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

Comment déployer Open WebUI sur le NAS QNAP et se connecter à 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.

Ouvrez SSH ou File Station sur votre NAS QNAP. Créez un répertoire pour les données persistantes d'Open WebUI :
/share/Container/open-webui

Ce répertoire stocke l'historique des discussions, les paramètres utilisateur et les données de configuration. Sans ce montage de volume, toutes vos conversations disparaissent lorsque le conteneur redémarre.

Dans Container Station, créez une nouvelle application avec le contenu suivant :

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

Explication de la configuration clé

• Image :ghcr.io/open-webui/open-webui:main — Image officielle Open WebUI du registre de conteneurs GitHub
• Port :3000:8080 — Accès depuis le navigateur à http://NAS-IP:3000, mappé au port 8080 du conteneur
• Volume :/share/Container/open-webui:/app/backend/data — Stockage persistant pour les discussions et les paramètres
• OLLAMA_BASE_URL :http://ollama:11434 — Doit correspondre au nom de service et au port de votre conteneur Ollama
• Réseau :ai-network — Réseau de pont partagé avec le conteneur Ollama
• Redémarrage :unless-stopped — Le conteneur redémarre automatiquement après le redémarrage de QNAP

Attendez 30 à 60 secondes pour que le conteneur démarre. Vérifiez les journaux dans Container Station.

Ouvrez votre navigateur et accédez à :
http://YOUR-NAS-IP:3000

Capture d'écran : écran de connexion Open WebUI avec champs d'inscription

Lors du premier accès, Open WebUI affiche un formulaire d'inscription. Remplissez :

• Nom : Votre nom d'affichage
• Email : Une adresse e-mail (n'a pas besoin d'être valide)
• Mot de passe : Un mot de passe sécurisé pour votre compte

Le premier compte créé devient automatiquement le compte admin. Vous devez créer ce compte avant que l'interface ne se déverrouille. Cliquez sur Créer un compte.

Après vous être connecté, Open WebUI affiche un sélecteur de modèle. Si vous avez déjà téléchargé des modèles dans Ollama, ils apparaissent ici automatiquement. Si aucun modèle n'est listé :

1. Allez dans le menu admin Panel
2. Sélectionnez Paramètre -> Modèles
3. Vérifiez les connexions Ollama et affichez la disponibilité des modèles.
4. Tirez un modèle directement depuis Open WebUI ou retournez à Ollama pour en tirer un d'abord

Sélectionnez un modèle dans le menu déroulant (par exemple, Gemma, Qwen, Deepseek).

Tapez un message dans la boîte de texte en bas et appuyez sur Entrée. Open WebUI envoie votre message à Ollama, qui le traite en utilisant le modèle sélectionné et renvoie une réponse. L'interface stocke la conversation complète dans votre volume persistant.

Capture d'écran : interface de chat Open WebUI avec une conversation d'exemple

Si vous souhaitez qu'Open WebUI se connecte à Ollama exécuté sur un autre NAS QNAP ou machine (pas le même hôte physique), modifiez la variable d'environnement :
OLLAMA_BASE_URL: http://OTHER-NAS-IP:11434

Remplacez OTHER-NAS-IP par l'adresse IP de la machine distante exécutant Ollama. Assurez-vous que le Pare-feu de cette machine autorise le trafic du port 11434 depuis votre NAS QNAP. Les deux machines doivent être sur le même réseau ou avoir une configuration de routage appropriée.