openwebui

# 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

```bash
# 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

#