SaaS chat subscriptions add up—ChatGPT Plus, Claude Pro, and team seats can exceed $20–30 per user per month while your prompts and uploaded files live on someone else's servers. Open WebUI (MIT-licensed, 110,000+ GitHub stars as of June 2026) gives you a polished, ChatGPT-like web interface that runs on your Mac: connect Ollama for free local models, or route to OpenAI-compatible APIs (OpenRouter, DeepSeek, Groq) while keeping the UI and document library under your control.
For beginners who want privacy + RAG without wiring LangChain by hand, Open WebUI ships built-in Retrieval Augmented Generation: upload PDFs and Markdown to a document library, then reference them in chat with the # command before your question. This guide walks through a one-command Docker install on macOS, first model pull, and a minimal knowledge-base workflow—no NodeMac pricing pitch, just upstream paths from the official docs.
Open WebUI + Ollama の構成
Open WebUI is the browser-facing layer; Ollama (or a remote OpenAI-compatible endpoint) is the inference engine. Persistent state lives in a Docker volume mounted at /app/backend/data.
Browser → http://localhost:3000 (or :8080 with --network=host)
→ Open WebUI container (FastAPI + Svelte UI)
→ Ollama at host.docker.internal:11434 OR OPENAI_API_BASE_URL
→ Vector DB (default embedded) + uploaded docs in data volume
→ RAG: user types "#" + selects document collection before prompt| コンポーネント | デフォルト位置 / 設定 | 役割 |
|---|---|---|
| Web UI | Port 3000 mapped to container 8080 | Chat, admin, model picker |
| Ollama | 11434 on host or bundled in :ollama image | Pull/run llama3, qwen2.5, etc. |
| Document library | Admin → Documents / Workspace | PDF, TXT, MD for RAG |
| RAG trigger | # in chat input | Attach knowledge to a single turn |
| Data volume | -v open-webui:/app/backend/data | Required—stores DB + uploads |
Quotable: Upstream warns that omitting the open-webui named volume wipes users, chats, and uploaded documents on container recreate—always mount -v open-webui:/app/backend/data.
出典： Open WebUI README and getting-started docs.
ChatGPT Plus vs 自前 Open WebUI
| 要素 | ChatGPT Plus（約 $20/月） | Open WebUI + Ollama（ローカル） |
|---|---|---|
| Data residency | OpenAI servers | Your Mac / your Docker volume |
| Document RAG | GPT store / limited uploads | Full doc library + # per chat |
| Model choice | OpenAI models only | Any Ollama model + API backends |
| Offline use | No | Yes, with local models pulled |
| Setup time | 0 minutes | ~15–30 minutes first install |
| 継続コスト | サブスク | 電気代 + 任意 API キー |
If you only need occasional GPT-4o quality, do point Open WebUI at a cheap OpenAI-compatible API and skip heavy local models. If you want zero cloud inference, do use the bundled :ollama image and models like llama3.2:3b on a 16 GB Mac—see Apple Mac mini specifications for baseline RAM.
macOS ステップバイステップ手順
- Install Docker Desktop — Open WebUI's recommended path for Mac beginners. Enable WSL-like VM resources: allocate 8 GB+ RAM to Docker if you run 7B+ models.
- Choose install flavor — Three common patterns:
# A) Open WebUI only — Ollama already running on Mac (brew install ollama && ollama serve)
docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway \
-v open-webui:/app/backend/data --name open-webui --restart always \
ghcr.io/open-webui/open-webui:main
# B) Bundled Open WebUI + Ollama (simplest one-container start)
docker run -d -p 3000:8080 -v ollama:/root/.ollama -v open-webui:/app/backend/data \
--name open-webui --restart always ghcr.io/open-webui/open-webui:ollama
# C) Connection issues? Use host networking (note port becomes 8080)
docker run -d --network=host -v open-webui:/app/backend/data \
-e OLLAMA_BASE_URL=http://127.0.0.1:11434 --name open-webui --restart always \
ghcr.io/open-webui/open-webui:main- Open the UI — Visit http://localhost:3000 (or http://localhost:8080 with
--network=host). Create the first admin account—registration closes after the first user on private installs. - Pull a starter model — In another terminal (if using separate Ollama):
ollama pull llama3.2:3b
# or for Chinese/English mix: ollama pull qwen2.5:7bBundled :ollama image: use Admin → Settings → Models or docker exec -it open-webui ollama pull llama3.2:3b.
- Select model in chat — Top bar → pick
llama3.2:3b. Send a test prompt to confirm Ollama connectivity. - Build document library (RAG) — Admin → Documents (or Workspace files): upload PDFs,
.md,.txt. Wait for embedding to finish (status in UI). - Query with
#— In a new chat, type#, select your collection or file, then ask: "Summarize refund policy section 3." Open WebUI injects retrieved chunks into the prompt. - Optional: OpenAI-compatible API — Settings → Connections: set base URL (e.g. DeepSeek, OpenRouter) + API key for cloud models while keeping the same UI and doc library.
Alternative (pip): pip install open-webui && open-webui serve runs on http://localhost:8080 without Docker—upstream requires Python 3.11.
トラブルシューティング
"Open WebUI: Server Connection Error" (Ollama unreachable)
Symptom: Models list empty; error mentions 127.0.0.1:11434 inside container.
Fix: Docker on Mac cannot reach host Ollama via bare localhost. Use --add-host=host.docker.internal:host-gateway (pattern A) or --network=host (pattern C). Verify: curl http://127.0.0.1:11434/api/tags on the host shows models.
Wrong port after install
Symptom: Browser cannot connect.
Fix: Default mapped install uses host port 3000. --network=host switches to 8080. Pip install also uses 8080. Match your URL to the command you ran.
Documents uploaded but # returns nothing
Symptom: RAG attach succeeds but answers ignore file content.
Fix: Confirm embedding completed (no error badge on document). Retry with a smaller PDF. Check Admin → Settings → Documents / RAG: ensure the collection is included in chat and the model supports context length.
Container recreate lost all chats
Symptom: Fresh install after docker rm.
Fix: You omitted or deleted the open-webui volume. Always use -v open-webui:/app/backend/data. Inspect with docker volume inspect open-webui.
関連記事
Open WebUI のドキュメントライブラリを OpenHuman Mac mini M4 の OAuth メモリと組み合わせるか、同じ常時稼働 Mac mini で Understand-Anything ナレッジグラフ を実行。
Open WebUI でモデルを固定する際は
GPT-5.6 iris-alpha Codex リーク追跡
でカナリアを監視—system card まで gpt-5.5 を固定。
Mac で Apple Intelligence を追うなら WWDC 2026 All Systems Glow Siri リーク解説 —証拠マトリクス、8 ステップ、FAQ 5 件。
よくある質問
Open WebUI は OpenAI の ChatGPT と同じですか？
いいえ。Open WebUI は Ollama、OpenAI API、その他互換バックエンドに接続できるオープンソースの自前 UI です。ChatGPT 風の体験を自前インフラで提供し、モデル・ユーザー・ドキュメント保存を自分で管理できます。
Mac mini M4 に GPU は必要ですか？
Apple Silicon で 3b–7b 量子化小モデルなら不要—Ollama は統合メモリを使用。16 GB で llama3.2:3b は快適；7b + 埋め込み同時なら 24 GB 推奨。NVIDIA :cuda イメージは Linux/NVIDIA 向けで Mac Docker には非対応。
完全オフラインで使えますか？
はい—ollama pull 後にクラウド API を使わなければ可能。オフライン環境では upstream README の HF_HUB_OFFLINE=1 で HuggingFace 取得を遮断。
RAG は ChatGPT のファイルアップロードと何が違いますか？
Open WebUI は ChromaDB、PGVector 等のベクトル DB でドキュメントライブラリを保持。# コマンドでメッセージごとにコレクションを添付—多プロジェクト KB に向く。
Docker がノート PC で重い場合は？
常時稼働 Mac mini で pip install、または SSH 先の専用ホストで Docker。PWA 対応—LAN の http://your-mac-ip:3000 でモバイルアクセス可（認証強化なしのポート転送は非推奨）。