openwebui-cli/docs/guides/configuration.md

Configuration Guide

The CLI reads settings from CLI flags, environment variables, and a config file.

Precedence

CLI flags → environment variables → config file → defaults.

Config file locations

• Linux/macOS: ~/.config/openwebui/config.yaml
• Windows: %APPDATA%\openwebui\config.yaml

Example config

version: 1
default_profile: default
profiles:
  default:
    uri: http://localhost:8080
defaults:
  model: llama3.2:latest
  format: text
  stream: true
  timeout: 30
output:
  colors: true
  progress_bars: true
  timestamps: false

Environment variables

• OPENWEBUI_PROFILE – override profile name
• OPENWEBUI_URI – override server URI
• OPENWEBUI_TOKEN – token when keyring is unavailable or in CI

Tokens and keyring

• Tokens are stored in system keyring under service openwebui-cli (key <profile>:<uri>).
• If no keyring backend is available, pass --token or set OPENWEBUI_TOKEN.
• For headless/CI, install a lightweight backend (e.g., keyrings.alt) or rely on env/flags.

Profiles

• Set default profile via openwebui config init or editing the config file.
• Override per command with --profile NAME (and optionally --uri).

Output formats

• Global --format flag accepts text, json, yaml.
• Defaults are stored under defaults.format in the config.