Open WebUI

#open-webui #ollama #self-hosted #yerel-llm #açık-kaynak #web-arayüzü #gizlilik #docker

Yerel yapay zeka modellerini çalıştırmak için self-hosted, açık kaynaklı web arayüzü.

Open WebUI, Ollama ve OpenAI uyumlu API'ler aracılığıyla yerel büyük dil modellerine erişmek için kendi sunucunuzda barındırabileceğiniz açık kaynaklı bir web arayüzüdür. ChatGPT benzeri bir deneyimi tamamen özel ortamda sunan Open WebUI; konuşma geçmişi, model yönetimi, RAG pipeline desteği ve çoklu kullanıcı özellikleriyle öne çıkar. Açık kaynak yapay zeka araçlarının popülerleşmesiyle birlikte kullanıcılar, verilerini üçüncü taraf bulut servislerine göndermeden güçlü dil modellerinden yararlanmak istemeye başladı. Open WebUI bu ihtiyaca yanıt veren en kapsamlı self-hosted çözümlerden biridir. Proje, 2023 yılında başlayarak kısa sürede GitHub'da on binlerce yıldız topladı ve aktif bir topluluk desteğiyle gelişmeye devam etmektedir. Teknik açıdan Open WebUI; Docker konteyneri olarak çalışır ve Ollama aracılığıyla Llama, Mistral, Gemma gibi yerel modellere; OpenAI API anahtarıyla da GPT serilerine bağlanabilir. Arayüz; sohbet geçmişini yerel veritabanında saklar, farklı modeller arasında anlık geçiş yapılmasına izin verir ve kullanıcı başına ayrı profil yönetimi sunar. Bunlara ek olarak, PDF ve web sayfalarını bilgi tabanına ekleyerek model yanıtlarını zenginleştiren bir RAG (Retrieval-Augmented Generation) motoru da yerleşik olarak gelir. Veri gizliliği açısından Open WebUI kritik bir avantaj taşır: tüm sohbet içerikleri ve belgeler kullanıcının kendi altyapısında kalır. Türkiye'deki şirketler, KVKK kapsamında kişisel veri içeren sorguları bulut tabanlı yapay zeka servislerine göndermekten kaçınmak için Open WebUI gibi yerel çözümlere yönelmektedir. Özellikle hukuk, sağlık ve finans sektöründe bu tür gizlilik gereksinimleri belirleyici olmaktadır. Kurulum açısından bakıldığında, Docker yüklü herhangi bir Linux sunucusu veya macOS makinesi üzerinde tek bir komutla çalıştırılabilmesi Open WebUI'yi erişilebilir kılar. GPU desteği isteğe bağlıdır; CPU üzerinde çalışan küçük modeller düşük donanımlı ortamlarda da kullanılabilir. Bu esneklik, bireylerin kişisel bilgisayarlarından kurumsal veri merkezlerine kadar geniş bir dağıtım yelpazesini kapsar.

Open WebUI Nedir?

Open WebUI, yerel büyük dil modellerini web tarayıcısı üzerinden kullanmayı sağlayan açık kaynaklı bir arayüzdür. Kullanıcılara ChatGPT benzeri bir deneyim sunarken tüm veri işlemeyi kendi altyapılarında gerçekleştirmelerine imkân tanır. Hem bireysel geliştiriciler hem de gizlilik öncelikli kurumlar için tercih edilen self-hosted çözümlerden biridir.

Temel Özellikler

Open WebUI'nin öne çıkan özellikleri şunlardır: Ollama ve OpenAI uyumlu API'lerle çoklu model desteği, konuşma geçmişini yerel veritabanında saklama, PDF ve web sayfası tabanlı RAG (Retrieval-Augmented Generation) motoru, çoklu kullanıcı ve rol yönetimi, model parametrelerini arayüzden ayarlama ve konuşmaları dışa aktarma. Ayrıca sistem istemi (system prompt) şablonları ve promptları paylaşma özellikleri topluluk kullanımını kolaylaştırır.

Kurulum ve Gereksinimler

Open WebUI'yi çalıştırmak için Docker yüklü bir ortam yeterlidir. En basit kurulumda önce Ollama yüklenerek yerel bir model indirilir, ardından Open WebUI Docker imajı tek komutla başlatılır. GPU isteğe bağlıdır: NVIDIA GPU varsa hız artar, ancak küçük modeller (1–7B parametre) CPU üzerinde de makul sürelerde yanıt üretebilir. macOS, Linux ve Windows (WSL2) üzerinde çalışır.

RAG ve Belge Entegrasyonu

Open WebUI'nin yerleşik RAG motoru, kullanıcıların kendi belgelerini (PDF, DOCX, web URL'si) arayüze yükleyerek model yanıtlarını bu içerikle zenginleştirmesini sağlar. Belgeler vektör veritabanında saklanır ve her sohbette semantik arama yapılarak ilgili parçalar modele bağlam olarak iletilir. Bu özellik, şirket içi doküman sorgulama veya kişisel bilgi tabanı oluşturma senaryolarında büyük değer taşır.

Gizlilik ve KVKK Uyumu

Open WebUI'nin en kritik avantajlarından biri, tüm sohbet içerikleri ve belgelerin kullanıcının kendi sunucusunda kalmasıdır. Türkiye'deki KVKK düzenlemeleri kapsamında kişisel sağlık, hukuki veya finansal verileri bulut tabanlı yapay zeka servislerine göndermek riskli olabilir. Open WebUI bu tür kurumların yapay zekadan faydalanırken veri egemenliğini korumasına olanak tanır. Kurumsal dağıtımlarda erişim kısıtlamaları ve ağ izolasyonuyla ek güvenlik katmanları eklenebilir.

Ollama ile Fark ve Benzer Araçlar

Ollama, modelleri yerel olarak indiren ve çalıştıran bir arka uç katmanıdır; Open WebUI ise bu katmanın üzerine oturan görsel arayüzdür. Benzer arayüzler arasında LM Studio (masaüstü uygulaması, daha az özelleştirme), Jan (sade arayüz), Anything LLM (kurumsal odaklı) sayılabilir. Open WebUI'yi öne çıkaran faktörler; API esnekliği, RAG desteği ve aktif topluluk geliştirmesidir.

Sıkça Sorulan Sorular

Open WebUI ücretsiz mi? Evet, MIT lisansıyla tamamen ücretsiz ve ticari kullanıma açık.

GPU olmadan çalışır mı? Evet. CPU üzerinde de çalışır; 7B ve altı modeller kabul edilebilir sürelerde yanıt üretir.

ChatGPT ile birlikte kullanılabilir mi? Evet, OpenAI API anahtarı ekleyerek GPT modellerini de aynı arayüzden kullanabilirsiniz.

Verilerim nerede saklanır? Tüm sohbet geçmişi ve belgeler, Open WebUI'nin çalıştığı sunucudaki yerel veritabanında saklanır; hiçbir veri dışarı gönderilmez.

Kurumsal kullanım için uygun mu? Evet. Çoklu kullanıcı, rol yönetimi ve ağ izolasyonu desteğiyle kurumsal dağıtıma uygundur.

Hangi modelleri destekler? Ollama üzerinden Llama, Mistral, Gemma, Phi, Qwen ve diğer tüm GGUF uyumlu modelleri; OpenAI API üzerinden GPT-4o ve benzeri modelleri destekler.

terminal Docker ile kurulum: kopyala yapıştır komutlar

Ollama zaten kuruluysa tek satır yeterli. Terminalde 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 komutunu çalıştırın, sonra tarayıcıdan localhost:3000 adresine gidin. Kayıt olan ilk kullanıcı otomatik olarak yönetici olur.

Ollama kurulu değilse ikisini tek imajda başlatabilirsiniz: docker run -d -p 3000:8080 --gpus all -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:ollama NVIDIA kartı yoksa --gpus all kısmını silin; imaj CPU üzerinde de çalışır, yalnızca yanıtlar yavaşlar.

Docker kullanmak istemeyenler için Python yolu var: 3.11 sürümlü bir sanal ortamda pip install open-webui ve ardından open-webui serve. Bu kurulumda arayüz 8080 portunda açılır.

Güncelleme iki komut: docker pull ghcr.io/open-webui/open-webui:main ile yeni imajı çekin, docker rm -f open-webui ile eski kabı silin ve ilk komutu aynı volume adıyla tekrar çalıştırın. Sohbetler ve yüklenen belgeler open-webui adlı Docker volume içindeki webui.db dosyasında durur, bu yüzden kab silinse bile veri kalır. Yedek almak için bu volume'u kopyalamanız yeterli.

troubleshoot Sık karşılaşılan hatalar ve çözümleri

  • check_circle Ollama sunucusuna bağlanamıyor: Kabın içinden ana makineye erişim gerekir. OLLAMA_BASE_URL değerini http://host.docker.internal:11434 yapın, Linux'ta komuta --add-host=host.docker.internal:host-gateway ekleyin. Ollama yalnızca 127.0.0.1 dinliyorsa servisi OLLAMA_HOST=0.0.0.0 ile yeniden başlatın.
  • check_circle Model listesi boş geliyor: Open WebUI sadece Ollama'da indirilmiş modelleri listeler. Terminalde ollama pull llama3.2 ile bir model indirin, ollama list çıktısında göründüğünü doğrulayın, sonra arayüzü yenileyin.
  • check_circle Yeni kullanıcı giriş yapamıyor: İlk kayıt olan hesap yönetici olur, sonraki kayıtlar varsayılan olarak onay bekler. Yönetici panelindeki kullanıcılar bölümünden rolü değiştirin. Kayıtları tamamen kapatmak için kabı ENABLE_SIGNUP=false ortam değişkeniyle başlatın.
  • check_circle Mikrofon ve pano erişimi çalışmıyor: Tarayıcılar mikrofon, kamera ve pano iznini yalnızca localhost veya HTTPS üzerinden verir. Sunucuya alan adıyla erişiyorsanız Nginx ya da Caddy ile sertifika kurmadan bu özellikler kapalı kalır.
  • check_circle Yanıtlar akmıyor, sohbet takılıyor: Ters vekil sunucu WebSocket yükseltmesini iletmiyor olabilir. Nginx yapılandırmasına proxy_set_header Upgrade $http_upgrade; ve proxy_set_header Connection "upgrade"; satırlarını ekleyin, proxy_read_timeout değerini de uzun tutun.
  • check_circle Güncellemeden sonra sohbetler kayboldu: Kab -v open-webui:/app/backend/data bağlanmadan çalıştırıldıysa veriler kabla birlikte silinir. Doğru volume ile yeniden kurun; eski kab hâlâ duruyorsa docker cp ile /app/backend/data içeriğini dışarı alıp taşıyabilirsiniz.

language Türkçe arayüz ve ekip içi kullanım

Arayüz dili ayarlardan değiştirilir: Settings, sonra General, oradan Language listesinden Türkçe. Çeviri topluluk katkısıyla ilerlediği için yeni eklenen bazı menüler İngilizce görünebilir. Arayüz dili ile yanıt dili ayrı şeyler; modelin Türkçe cevap vermesi için ya sistem istemine Türkçe yanıt verme yönergesi eklemeniz ya da Türkçe'de iyi çalışan bir model seçmeniz gerekir. Qwen 2.5 ve Llama 3.1 ailesinin çok dilli sürümleri 7B ölçeğinde kabul edilebilir Türkçe üretir.

Ekip kullanımında kullanıcı grupları ve model izinleri yönetici panelinden tanımlanır; hangi grubun hangi modeli göreceğini tek tek seçebilirsiniz. Sunucuyu şirket ağının dışına açacaksanız önce HTTPS kurun, kayıtları kapatın, giriş hakkını davet ettiğiniz hesaplarla sınırlayın. Kurulum şirket içi bir sunucuda durduğu sürece sohbetler ve yüklenen belgeler o makineden çıkmaz; KVKK kapsamındaki belgeler için bulut arayüzlerine göre savunması daha kolay bir düzendir.

help Sıkça Sorulan Sorular

  • check_circle Open WebUI nasıl kurulur? Docker kuruluysa tek komut yeter: docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main. Kurulum bitince arayüz localhost:3000 adresinde açılır ve ilk kayıt olan kullanıcı yönetici olur. Docker istemeyenler Python 3.11 ortamında pip install open-webui ve open-webui serve komutlarını kullanabilir.
  • check_circle Open WebUI Türkçe destekliyor mu? Evet, arayüz dili ayarlardan Türkçe'ye alınabilir. Çeviri topluluk katkısıyla sürdüğü için yeni menülerin bir kısmı İngilizce kalabilir. Yanıtların Türkçe olması arayüz diline değil seçtiğiniz modele bağlıdır; 7B sınıfında Qwen 2.5 ve çok dilli Llama sürümleri makul sonuç verir.
  • check_circle Open WebUI nasıl güncellenir? docker pull ghcr.io/open-webui/open-webui:main ile yeni imajı çekin, eski kabı silin ve aynı volume adıyla yeniden başlatın. Sohbet geçmişi open-webui volume'unda durduğu için güncelleme sırasında kaybolmaz. Otomatik güncelleme isteyenler Watchtower gibi bir araç ekleyebilir.
  • check_circle Open WebUI'ye dışarıdan erişim nasıl açılır? Sunucunun önüne Nginx veya Caddy koyup alan adına TLS sertifikası alın ve trafiği 3000 portuna yönlendirin. WebSocket yükseltme başlıkları iletilmezse yanıt akışı takılır. Açık internete çıkmadan önce kayıtları kapatın, mümkünse VPN ya da IP kısıtı ekleyin.