Open WebUI

Open WebUI

Open WebUI is a self-hosted chat interface for LLMs. Because it speaks the standard OpenAI API format, you can connect it to LivRouter either in the Admin Panel UI or via Docker environment variables and expose the entire catalog to your workspace.

Option 1: Configure in the Admin Panel (recommended)

  1. Sign in to Open WebUI as an administrator and open Admin Panel → Settings → Connections.
  2. Under OpenAI API, click + to add a new connection.
  3. Set URL to https://api.livrouter.com/v1.
  4. Paste your LivRouter API key into the Key field and click Verify Connection.
  5. Save the connection so Open WebUI fetches available model IDs from https://api.livrouter.com/v1/models.

Option 2: Configure with Docker environment variables

bash
docker run -d -p 3000:8080 \  -e OPENAI_API_BASE_URL="https://api.livrouter.com/v1" \  -e OPENAI_API_KEY="your-livrouter-api-key" \  --name open-webui \  ghcr.io/open-webui/open-webui:main

Keep the API key in an environment file or secret store rather than committing it to a public compose file. You can also filter visible models inside Open WebUI's model settings so users only pick models enabled on your LivRouter key group.

Verify and troubleshoot

  • Empty model dropdown: verify that the URL ends with /v1 and click the refresh icon next to the OpenAI connection.
  • 401 or 403 on chat: check that the key is active on the API keys page and has prepaid credit balance.
  • Model ID not available: confirm the selected ID is listed in the live model catalog and inspect Usage logs.

See the OpenAI-compatible API guide or API quickstart for request details.