shield_lock
金大哥
联系我们
← 返回 Skill 列表
extension
分类: 内容与媒体无需 API Key

openwebui

通过Podman Quadlet打开WebUI AI聊天界面管理。提供一个用于与Ollama模型交互的网页界面。当用户需要配置、启动或管理Open WebUI服务时使用。

person作者: jakexiaohubgithub
open_in_new仓库download下载资源包

Open WebUI - AI Chat Interface

Overview

The openwebui command manages the Open WebUI service using Podman Quadlet containers. It provides a web-based chat interface for interacting with Ollama LLM models.

Key Concept: Open WebUI connects to Ollama via the bazzite-ai network using DNS (http://ollama:11434). Ensure Ollama is running before using Open WebUI.

Quick Reference

| Action | Command | Description | |--------|---------|-------------| | Config | ujust openwebui config | Configure Open WebUI | | Delete | ujust openwebui delete | Remove instance config and container | | Logs | ujust openwebui logs [--lines=N] | View container logs | | Restart | ujust openwebui restart | Restart server | | Shell | ujust openwebui shell [-- CMD] | Open shell or execute command in container | | Start | ujust openwebui start | Start Open WebUI server | | Status | ujust openwebui status | Show instance status | | Stop | ujust openwebui stop | Stop Open WebUI server | | URL | ujust openwebui url | Show web UI access URL |

Parameters

| Parameter | Long Flag | Short | Default | Description | |-----------|-----------|-------|---------|-------------| | Port | --port | -p | 3000 | Host port for web UI | | Image | --image | -i | ghcr.io/open-webui/open-webui:main | Container image | | Tag | --tag | -t | main | Image tag | | Bind | --bind | -b | 127.0.0.1 | Bind address | | Config Dir | --config-dir | -c | ~/.config/openwebui/1 | Config/data directory | | Workspace | --workspace-dir | -w | (empty) | Workspace mount | | GPU Type | --gpu-type | -g | auto | GPU type | | Instance | --instance | -n | 1 | Instance number or all | | Lines | --lines | -l | 50 | Log lines to show |

Configuration

# Default configuration (port 3000, localhost only)
ujust openwebui config

# Custom port (long form)
ujust openwebui config --port=3001

# Custom port (short form)
ujust openwebui config -p 3001

# Network-wide access
ujust openwebui config --bind=0.0.0.0

# Combine parameters (long form)
ujust openwebui config --port=3001 --bind=0.0.0.0

# Combine parameters (short form)
ujust openwebui config -p 3001 -b 0.0.0.0

# GPU-optimized image
ujust openwebui config --image=ghcr.io/open-webui/open-webui:cuda

Update Existing Configuration

Running config when already configured updates the existing settings:

# Change only the bind address
ujust openwebui config --bind=0.0.0.0

# Update port without affecting other settings
ujust openwebui config --port=3002

Container Images

| Image | Description | |-------|-------------| | ghcr.io/open-webui/open-webui:main | Standard image (default) | | ghcr.io/open-webui/open-webui:cuda | NVIDIA CUDA optimized | | ghcr.io/open-webui/open-webui:ollama | Bundled with Ollama (not recommended) |

Note: GPU is auto-detected and attached regardless of image choice.

Lifecycle Management

# Start Open WebUI
ujust openwebui start

# Stop service
ujust openwebui stop

# Restart (apply config changes)
ujust openwebui restart

# View logs (default 50 lines)
ujust openwebui logs

# View more logs (long form)
ujust openwebui logs --lines=200

# View more logs (short form)
ujust openwebui logs -l 200

# Check status
ujust openwebui status

# Show access URL
ujust openwebui url

Multi-Instance Support

# Start all instances (long form)
ujust openwebui start --instance=all

# Start all instances (short form)
ujust openwebui start -n all

# Stop specific instance
ujust openwebui stop --instance=2

# Delete all instances
ujust openwebui delete --instance=all

Shell Access

# Interactive shell
ujust openwebui shell

# Run specific command (use -- separator)
ujust openwebui shell -- ls -la /app/backend/data
ujust openwebui shell -- cat /app/backend/data/config.json

Network Architecture

Open WebUI uses the bazzite-ai bridge network for cross-container DNS:

+-------------------+     DNS      +-------------------+
|   Open WebUI      | -----------> |      Ollama       |
|   (openwebui)     |              |    (ollama)       |
|   Port 3000       |              |   Port 11434      |
+-------------------+              +-------------------+
         |                                  |
         +------ bazzite-ai network --------+

Environment Variables (injected automatically):

OLLAMA_BASE_URL=http://ollama:11434
OLLAMA_HOST=http://ollama:11434
JUPYTER_HOST=http://jupyter:8888
COMFYUI_HOST=http://comfyui:8188

Network Binding

| Bind Address | Access | Use Case | |--------------|--------|----------| | 127.0.0.1 | Localhost only | Default, secure | | 0.0.0.0 | All interfaces | Network access, Tailscale |

Security Note: Using --bind=0.0.0.0 exposes the service to your network. Consider using Tailscale for secure remote access:

# Expose via Tailscale (secure)
ujust tailscale serve --service=openwebui

Data Persistence

| Path | Description | |------|-------------| | ~/.config/openwebui/<INSTANCE>/data | Users, chats, settings |

Data persists across container restarts. Each instance has isolated data.

Common Workflows

Initial Setup

# 1. Ensure Ollama is running
ujust ollama start

# 2. Configure Open WebUI
ujust openwebui config

# 3. Start the service
ujust openwebui start

# 4. Access the web UI
ujust openwebui url
# Output: http://127.0.0.1:3000

Remote Access Setup

# Configure for network access
ujust openwebui config --bind=0.0.0.0

# Start the service
ujust openwebui start

# Or use Tailscale for secure access
ujust tailscale serve --service=openwebui

Upgrade Container Image

# Stop service
ujust openwebui stop

# Update to new image
ujust openwebui config --image=ghcr.io/open-webui/open-webui:main

# Restart
ujust openwebui start

GPU Support

GPU is automatically detected and attached:

| GPU Type | Detection | Quadlet Config | |----------|-----------|----------------| | NVIDIA | nvidia-smi | AddDevice=nvidia.com/gpu=all | | AMD | lspci | AddDevice=/dev/dri | | Intel | lspci | AddDevice=/dev/dri |

Check GPU status:

ujust openwebui shell -- nvidia-smi

Troubleshooting

Service Won't Start

# Check status
ujust openwebui status

# View logs
ujust openwebui logs --lines=100

# Check if Ollama is running
ujust ollama status

Common causes:

  • Port 3000 already in use
  • Ollama not running
  • Container image not pulled

Can't Connect to Ollama

Symptom: "No models available" in web UI

Check:

# Verify Ollama is running
ujust ollama status

# Test Ollama connection from Open WebUI container
ujust openwebui shell -- curl http://ollama:11434/api/tags

Fix:

# Start Ollama first
ujust ollama start

# Restart Open WebUI
ujust openwebui restart

Web UI Not Accessible

Symptom: Browser can't connect to http://localhost:3000

Check:

ujust openwebui status
ujust openwebui url

Fix:

# If using wrong bind address
ujust openwebui config --bind=127.0.0.1
ujust openwebui restart

Clear Data and Start Fresh

# Delete everything
ujust openwebui delete --instance=all

# Reconfigure
ujust openwebui config
ujust openwebui start

Cross-References

  • Required: ollama (Ollama must be running for models)
  • Related: jupyter (ML development), comfyui (image generation)
  • Network: Uses bazzite-ai network (shared with ollama, jupyter, comfyui)
  • Docs: Open WebUI GitHub

When to Use This Skill

Use when the user asks about:

  • "install open webui", "setup chat interface", "web ui for ollama"
  • "configure openwebui", "change port", "network access"
  • "open webui not working", "can't see models", "connection error"
  • "open webui logs", "debug open webui"
  • "delete open webui", "uninstall"