Open WebUI
You need administrator access to Open WebUI and a Link endpoint reachable from its backend.
Connect Open WebUI to Link
Slide 1 of 8: Open WebUI chat page.
Read the connection settings and Docker guidance
You need a running Open WebUI instance with administrator access and a tested Link endpoint.
Add a connection
Open the profile menu, then Admin Panel → Settings → Connections → Manage OpenAI API Connections, and add a connection.
| Field | Value |
|---|---|
| URL | http://127.0.0.1:8100/v1 when the Open WebUI backend runs directly on the Link machine |
| API key | Leave empty for an unauthenticated endpoint, or use its configured credential |
| Model | Select the exact ID returned by the connection, for example Gemma 4 (X-Small) |
Use Verify Connection, then save. Verification requests the model list; saving alone does not test connectivity. This follows Open WebUI's OpenAI-compatible connection guide.
If Open WebUI runs in Docker
The backend connects to Link. Inside a container, 127.0.0.1 refers to the container itself.
For Docker Desktop on the Link machine, use http://host.docker.internal:8100/v1. Linux Docker may require an explicit host-gateway mapping. For a separate server, use a reachable address with appropriate network access controls.
Send a message
Open a new chat, select your Aventail model and send a short prompt. Confirm a complete response.
If verification fails, check serving status, port and connectivity from the backend's environment. If verification succeeds but chat fails, inspect the error and model ID. Start with text chat before testing uploads, tools or other model capabilities.