# Open WebUI


    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:main
```

Open 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.

      &larr; Use with your stack
      LibreChat &rarr;



Source: https://axforge.ai/docs/connect/open-webui/
