OpenWebUI setup

OpenWebUI stores an OpenAI-compatible connection through its administration interface. Prepare the Lumoswitch base URL, access key, and client-facing model name first.

Add a connection

1. Sign in as an OpenWebUI administrator.
2. Open the connection or OpenAI API settings.
3. Add an OpenAI-compatible connection.
4. Set the base URL to https://api.lumoswitch.com/v1.
5. Enter the Lumoswitch access key.
6. Save and refresh the model list.

The Lumoswitch-generated environment form is:

OPENAI_API_BASE_URL=https://api.lumoswitch.com/v1
OPENAI_API_KEY=your-lumoswitch-access-key

Security and troubleshooting

• Restrict connection settings to administrators.
• Keep access keys out of screenshots, browser consoles, and public Compose files.
• Use separate configurations and keys for separate environments.
• If no models appear, call /models with the same key and refresh the list.
• If the old URL remains active, restart OpenWebUI and remove duplicate connections.
• For stalled streaming, disable SSE buffering in the reverse proxy.