Connect → Open WebUI
Use AxForge with Open WebUI
Open WebUI is a self-hosted chat interface. Add AxForge as an OpenAI connection and its models show up in the model picker.
Run it pointed at AxForge
$ docker run -d -p 3000:8080 \
-e ENABLE_OPENAI_API=True \
-e OPENAI_API_BASE_URL=https://api.axforge.ai/v1 \
-e OPENAI_API_KEY=your-axforge-key \
-v open-webui:/app/backend/data \
--name open-webui ghcr.io/open-webui/open-webui:mainOpen WebUI calls GET /v1/models when the connection is saved and
auto-populates the model list. To add several backends, use the plural,
;-separated forms — keys pair to URLs by position:
-e OPENAI_API_BASE_URLS="https://api.axforge.ai/v1;http://other:11434/v1"
-e OPENAI_API_KEYS="axforge-key;other-key"These env vars are read once. Open WebUI stores them in
its database on first launch (they are "PersistentConfig"), so changing the env var
on a later restart of an existing volume has no effect — edit the connection under
Admin Settings → Connections instead. The base URL must include
/v1.
Check that it worked
Two things, and the second is the one that proves it end to end:
- AxForge models appear in the model picker at the top of a new chat. Open WebUI lists them by asking our
/v1/models, so if they are there, the connection works. - A message gets a streamed reply.
- The call appears in the console at Billing & usage within a minute or two. Nothing else confirms that your key reached our API — a reply alone could be a cache or another provider.
When it does not work
| What you see | What it means | Fix |
|---|---|---|
| The model list is empty | Open WebUI could not reach the API, or the key was refused | Settings → Connections shows the connection state; a container cannot reach localhost on your host |
401 | the key | re-enter it in Settings → Connections |
| Models list but replies fail | the connection is fine and the model id is not | pick from the list rather than typing an id |
Run the self-test first when you are unsure — it says in one click whether the problem is your key, your quota or us, so you know whether the tool is worth debugging at all.