A browser page opens, connects to one chosen model, and produces one non-sensitive conversation.
All Guides
Editorially reviewedNot run by HAACC

Open WebUI

Put a browser interface in front of a model you control and complete one local chat.

Suitable for
People who already have a model endpoint and want a friendlier interface for repeated use.
Do not start here if
Not the best first step if containers, local services, or model endpoints are all unfamiliar.
Visible result
A browser page opens, connects to one chosen model, and produces one non-sensitive conversation.
Time
90 min
Device
A computer that can run the current official deployment path
Account
A local admin account may be created; external model providers may require separate accounts
Cost
Interface cost and model-provider cost are separate; verify both
Data
Storage for containers, chat history, and models or model connections
HAACC check
Editorially reviewed
Not run by HAACC
01

Before you start

Device / REQ

A computer that can run the current official deployment path

Account / OPT

A local admin account may be created; external model providers may require separate accounts

Cost / OPT

Interface cost and model-provider cost are separate; verify both

Data / REQ

Storage for containers, chat history, and models or model connections

Experience / REQ

Comfort stopping a local service and reading current container instructions

02

The path

  1. 01

    Choose the model connection first

    Decide whether you will connect a local model or an external provider. Write down what data may leave your computer before installing the interface.

    Continue only whenYou can name the model provider and data boundary in one sentence.
  2. 02

    Separate the trial from important data

    Use a dedicated trial directory and record any local ports, volumes, and admin credentials you create. Do not mount personal folders.

    Continue only whenAll trial storage locations and credentials are listed before launch.
  3. 03

    Follow one official deployment path

    Use the current repository documentation for one supported deployment method. Do not combine commands from multiple tutorials or expose the service to the public internet.

    Continue only whenThe interface opens only on the local address you expected.
  4. 04

    Connect and test without private data

    Connect one model, send a harmless prompt, reload the page, and check whether history persists where expected.

    Continue only whenOne response appears and you know whether chat history was stored locally or by a provider.
What success looks like

The interface is reachable only where intended, one model responds, and the data path is understood.

03

Evidence boundary

HAACC reviewed the public source and shaped this path, but did not run the project on a clean machine. Treat every install step as unverified.

What HAACC checked

  • Repository identity, snapshot metrics, and the product's self-hosted interface purpose
  • A deployment decision path that separates model, interface, storage, and exposure

What remains unchecked

  • Current installation, upgrades, authentication, and removal
  • Repository license was not asserted by the captured GitHub license field
04

Stop and read

Stop

Do not expose the trial to the public internet

A local admin screen can become an attack surface. Public deployment requires authentication, updates, network controls, and a separate review.

Caution

Rights status is unresolved here

This page provides factual reference and a safe evaluation sequence, not copied documentation or a license grant.

05

When something fails

What you see

The page does not open or the port is already used

What to do

Stop the deployment. Read the official logs and port notes before changing configuration; do not expose a random public port.

What you see

The interface opens but no model answers

What to do

Keep interface and model troubleshooting separate. Confirm the model endpoint independently, then reconnect it.

How to stop and remove it

Stop the deployment, remove its containers and dedicated volumes using current official instructions, delete the trial directory, and revoke provider keys used for the test.

06

Turn it into your project

01

Private family knowledge desk

Design a strictly local interface for non-sensitive household manuals and record the data boundary.

02

Model comparison station

Compare two models on the same harmless prompts with visible cost and latency notes.

Shape my version
07

Source snapshot

Repository
open-webui/open-webui
Captured
2026-07-20
Stars at capture
145,957
Forks at capture
21,152
GitHub license field
NOASSERTION
Pinned revision
Not pinned
Open public source