Open WebUI Kurulumu: Ollama ile Kendi ChatGPT Benzeri Arayüzünüzü Kurun

Open WebUI nedir?

Ollama terminalde çalışır; ekip arkadaşınıza "terminali aç, ollama run yaz" demek gerçekçi değildir. Open WebUI bu boşluğu doldurur: ChatGPT'ye benzeyen, tarayıcıdan açılan, kullanıcı hesapları ve sohbet geçmişi olan bir arayüz. Arkada Ollama'ya ya da OpenAI uyumlu herhangi bir API'ye (LM Studio, hatta bulut sağlayıcılar) bağlanır. Belge yükleme, web arama, araç çağırma ve model karşılaştırma gibi özellikler de vardır. Proje açık kaynaklıdır: github.com/open-webui/open-webui.

Ön koşul: Ollama veya LM Studio

Open WebUI kendi başına model çalıştırmaz. Önce Ollama kurulumunu yapın ve en az bir model indirin:

ollama pull qwen3:8b

LM Studio kullanıyorsanız yerel sunucuyu başlatın; Open WebUI'nin ayarlarından OpenAI uyumlu bağlantı olarak http://host.docker.internal:1234/v1 adresini ekleyeceksiniz.

Docker ile kurulum

Docker Desktop (macOS, Windows) ya da Docker Engine (Linux) kurulu olmalı. Ollama ana makinede çalışıyorsa:

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

Komutun parçaları:

• -p 3000:8080: Arayüz localhost:3000 adresinde açılır.
• --add-host: Konteynerden ana makinedeki Ollama'ya (host.docker.internal:11434) ulaşmak için.
• -v open-webui:...: Kullanıcılar, sohbetler ve belgeler bu volume'da kalıcı olur.
• --restart always: Bilgisayar yeniden başlayınca kendisi kalkar.

NVIDIA ekran kartıyla Ollama'yı da aynı konteynerde çalıştırmak isteyenler için ghcr.io/open-webui/open-webui:ollama imajı vardır; --gpus=all bayrağıyla kullanılır.

pip ile kurulum

Docker istemeyenler için Python yolu (Python 3.11 önerilir):

pip install open-webui
open-webui serve

Arayüz http://localhost:8080 adresinde açılır. Sanal ortam (venv) kullanmanızı öneririz; güncelleme pip install -U open-webui ile yapılır.

İlk açılış ve kullanıcılar

1. Tarayıcıda adresi açın ve ilk hesabı oluşturun. İlk hesap yönetici olur.
2. Sol üstten modeli seçin; Ollama'daki modeller otomatik listelenir. Görünmüyorsa Ayarlar > Bağlantılar bölümünde Ollama adresini (http://host.docker.internal:11434) kontrol edin.
3. Yönetim panelinden (Admin Panel) kayıt olmayı kapatabilir, kullanıcıları elle ekleyebilir, hangi rolün hangi modeli göreceğini belirleyebilirsiniz.

Belgeler, araçlar ve modeller

• Belge yükleme (RAG): Sohbete PDF, Word ya da metin dosyası sürükleyin; soru sorun. Knowledge bölümünde kalıcı belge koleksiyonları oluşturup bir modele bağlayabilirsiniz: "Şirket prosedürleri" koleksiyonu gibi.
• Özel modeller: Mevcut bir modele sistem istemi ve belge koleksiyonu ekleyerek "Destek Asistanı" gibi adlandırılmış modeller yaratırsınız. İyi sistem istemi için prompt nedir? yazısına bakın.
• Model karşılaştırma: Aynı soruyu iki modele yan yana sorarsınız; model seçimi için pratik.
• Araçlar ve MCP: Web arama, kod çalıştırma ve MCP sunucuları ile dış sistemlere bağlanma desteklenir.
• OpenAI uyumlu bağlantılar: Bulut sağlayıcı anahtarı eklerseniz aynı arayüzden hem lokal hem bulut modelleri kullanılır.

Yerel ağda paylaşım ve güncelleme

Ofis ya da sınıftaki diğer bilgisayarların erişmesi için Open WebUI'nin çalıştığı makinenin IP adresini kullanın: http://192.168.1.20:3000. Güvenlik duvarında 3000 portunu yalnızca yerel ağa açın; internete açmak istiyorsanız önüne HTTPS veren bir ters vekil (Caddy, Nginx) koyun.

Güncelleme (Docker):

docker pull ghcr.io/open-webui/open-webui:main
docker stop open-webui && docker rm open-webui
# ardından yukarıdaki docker run komutunu yeniden çalıştırın; volume sayesinde veriler korunur

Yedek için open-webui volume'unu kopyalamanız yeterlidir. Böylece küçük bir ekip için verisi dışarı çıkmayan, abonelik gerektirmeyen bir yapay zeka asistanı kurulmuş olur; bunun neden önemli olduğunu lokal AI nedir? yazısında anlattık.