Open WebUI

Open WebUI is a self-hosted chat interface. Add Cloakray as an OpenAI connection and every model in the catalogue appears in its model picker.

In the admin settings

1. Open Admin Panel → Settings → Connections.
2. Under OpenAI API, add a connection.
3. Set the URL to https://api.cloakray.com/v1 and the key to your Cloakray key.
4. Save. Open WebUI loads the model list from GET /v1/models.

To keep the picker short, add the model IDs you want to the connection's model allowlist.

With environment variables

When starting the container:

docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL="https://api.cloakray.com/v1" \
  -e OPENAI_API_KEY="ckr_..." \
  -v open-webui:/app/backend/data \
  --name open-webui ghcr.io/open-webui/open-webui:main

Notes

• Image uploads work with models that accept images.
• Every chat is billed to the key's project. Create a dedicated key for Open WebUI so its usage is easy to find in analytics.