RUNLOCALAIv38
->Will it run?Best GPUCompareTroubleshootStartLearnPulseModelsHardwareToolsBench
Run check
RUNLOCALAI

Independently operated catalog for local-AI hardware and software. Hand-written verdicts. Source-cited claims. Reproducible commands when we have them.

OP·Eruo Fredoline
DIR
  • Models
  • Hardware
  • Tools
  • Benchmarks
TOOLS
  • Will it run?
  • Compare hardware
  • Cost vs cloud
  • Choose my GPU
  • Prompting kits
  • Quick answers
REF
  • All buyer guides
  • Learn local AI
  • Methodology
  • Glossary
  • Errors KB
  • Trust
EDITOR
  • About
  • Author
  • How we make money
  • Editorial policy
  • Contact
LEGAL
  • Privacy
  • Terms
  • Sitemap
MAIL · MONTHLY DIGEST
Get monthly local AI changes
Monthly recap. No spam.
DISCLOSURE

Some links on this site are affiliate links (Amazon Associates and other first-class retailers). When you buy through them, we earn a small commission at no extra cost to you. Affiliate links do not influence our verdicts — there are cards we rate highly that we don't have affiliate relationships with, and cards that sell well that we refuse to recommend. Read more →

© 2026 runlocalai.coIndependently operated
RUNLOCALAI · v38
  1. >
  2. Home
  3. /Learn
  4. /Courses
  5. /Ollama — Installation to Mastery
  6. /Ch. 15
Ollama — Installation to Mastery

15. Open WebUI Integration

Chapter 15 of 20 · 20 min
KEY INSIGHT

Open WebUI runs separately from Ollama and communicates via HTTP. The connection URL must be reachable from the container-use Docker networking or host.docker.internal for host connections.

Open WebUI is a self-hosted web interface for Ollama that provides ChatGPT-like features: conversation history, model switching, image uploads, and more.

Installation Methods

Docker (recommended):

docker run -d -p 3000:8080 \\
    -e OLLAMA_BASE_URL=http://host.docker.internal:11434 \\
    -v open-webui:/app/backend/data \\
    --name open-webui \\
    ghcr.io/open-webui/open-webui:main

Docker Compose (see Chapter 14).

Configuration Options

Open WebUI uses environment variables for configuration:

Variable Default Description
OLLAMA_BASE_URL http://localhost:11434 Ollama API URL
WEBUI_SECRET_KEY Auto Session encryption key
OLLAMA_API_BASE_URL OLLAMA_BASE_URL + /api API endpoint
ENABLE_IMAGE_GENERATION false Enable image generation

For Docker, pass these with -e:

docker run -d -p 3000:8080 \\
    -e OLLAMA_BASE_URL=http://192.168.1.100:11434 \\
    -e WEBUI_SECRET_KEY=mysecretkey \\
    ghcr.io/open-webui/open-webui:main

Authentication

Open WebUI supports user authentication out of the box. On first access, you create an admin account. Subsequent users can be invited or registered based on admin settings.

To disable authentication for local-only setups:

environment:
  - WEBUI_AUTH=False

Custom Modelfiles Integration

Open WebUI detects custom models created with Modelfiles automatically. If you deploy Modelfiles in a directory:

services:
  ollama:
    image: ollama/ollama:latest
    volumes:
      - ./Modelfiles:/root/.ollama/models/Modelfile

Restart Ollama after adding Modelfiles-the interface picks up new models after a refresh.

Troubleshooting

Open WebUI cannot connect to Ollama:

  1. Verify Ollama is running: curl http://localhost:11434
  2. Check the OLLAMA_BASE_URL environment variable
  3. For Docker networking, use host.docker.internal on Windows/Mac, or the service name (ollama) if using Docker Compose

Models not showing in the dropdown:

  1. Pull the model inside the Ollama container: docker exec ollama ollama pull llama3.2:1b
  2. Check docker exec ollama ollama list to verify
  3. Refresh the Open WebUI page
EXERCISE

Deploy Open WebUI with Ollama via Docker Compose. Create a custom Modelfile, place it in the Modelfiles directory, restart the Ollama container, and verify the custom model appears in Open WebUI's model selector.

← Chapter 14
Docker Compose Stack
Chapter 16 →
Continue.dev Integration