Skip to main content

Open WebUI

You need administrator access to Open WebUI and a Link endpoint reachable from its backend.

AVENTAIL / OPEN WEBUI

Connect Open WebUI to Link

Full view

Open WebUI chat page

The profile menu at the bottom left contains Admin Panel.

Slide 1 of 8: Open WebUI chat page.

Screenshots from the original guide. Use your own model ID and port. Use the arrows or progress marks to move between slides.
AVENTAIL / OPEN WEBUI

Connect Open WebUI to Link

Full view

Open WebUI chat page

The profile menu at the bottom left contains Admin Panel.

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.

FieldValue
URLhttp://127.0.0.1:8100/v1 when the Open WebUI backend runs directly on the Link machine
API keyLeave empty for an unauthenticated endpoint, or use its configured credential
ModelSelect 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.