Open WebUI

Self-hosted AI web platform supporting Ollama and any OpenAI-compatible API

Introduction

Open WebUI is a powerful self-hosted AI web platform that runs in Docker. Out of the box it works with local Ollama models, but you can also add any OpenAI-compatible API — including TokenMix. This gives you a private, full-featured AI interface backed by cloud models like Claude, GPT-5, and Qwen.

Prerequisites

• Install Docker on your machine. Then run:

  docker run -d -p 3000:8080 --name open-webui ghcr.io/open-webui/open-webui:main
  

  Open http://localhost:3000 and create an admin account on first launch.
• Sign up at tokenmix.ai and get your API Key from Console → API Keys (starts with sk-tm-).

Setup Steps

1. Log in to Open WebUI with your admin account.
2. Click your avatar (top-right) → Admin Settings.
3. Navigate to the Connections tab.
4. Under the OpenAI section, click the ➕ Add Connection button.
5. Fill in the fields:
   • URL: https://api.tokenmix.ai/v1
   • Key: paste your sk-tm-xxx key
6. Click Save.

Important: Open WebUI attempts to auto-discover models via the /models endpoint. TokenMix returns all available models, so the list should populate automatically. If specific models don't appear, proceed to step 7.

7. (Optional) Still in the connection settings, scroll to Model IDs (Filter) and manually enter the model IDs you want to use, e.g. claude-sonnet-4.6, gpt-5.4, qwen3.6-max-preview. Save again.

Verify

Go back to the main chat screen. Click the model selector dropdown at the top of the chat window. Your TokenMix models should be listed. Start a conversation to confirm everything works.

FAQ

Q: No models appear after saving the connection. A: Open WebUI requires the /v1/models endpoint to enumerate models. If the list is empty, use the Model IDs (Filter) field to manually specify the model short_ids you want: claude-sonnet-4.6, gpt-5.4, qwen3.6-max-preview.

Q: I get a 401 Unauthorized error. A: Verify the URL is exactly https://api.tokenmix.ai/v1 (no trailing slash, include /v1). Re-paste your key from the TokenMix console.

Q: How do I add Open WebUI for multiple users in my team? A: Open WebUI includes a full user management system. In Admin Settings → Users, invite team members and assign roles. The TokenMix connection is shared across all users through the admin panel.