Open WebUI इंस्टॉलेशन और OmniProxy कॉन्फ़िगरेशन

Open WebUI एक स्व-होस्टेड चैट इंटरफ़ेस है जिसे आपके अपने कंप्यूटर या सर्वर पर इंस्टॉल किया जा सकता है और यह पूरी तरह से ऑफ़लाइन भी चल सकता है। यह किसी एक मॉडल प्रदाता से बंधा नहीं है: यह Ollama जैसे टूल से कनेक्ट हो सकता है जो मॉडल को स्थानीय रूप से चलाते हैं, साथ ही OpenAI-संगत एंडपॉइंट्स से भी—ऐसे पते जो समान अनुरोध प्रारूप का उपयोग करके मॉडल सेवाएं प्रदान करते हैं। यह आपको एक ही विंडो में स्थानीय और क्लाउड मॉडल के बीच स्विच करने की सुविधा देता है।

यह टीमों और संगठनों द्वारा दीर्घकालिक उपयोग के लिए उपयुक्त है। जिन क्षमताओं को तेजी से अपडेट प्राप्त होते हैं, वे सबसे पहले Computer में दिखाई देते हैं, वह उत्पाद जिसका उपयोग Open WebUI नई सुविधाओं को आज़माने के लिए करता है।

शुरू करने से पहले

Open WebUI macOS, Linux और Windows पर उपलब्ध है। आप इसे Docker, Python या Kubernetes का उपयोग करके इंस्टॉल कर सकते हैं। Docker एप्लिकेशन और उसके रनटाइम एनवायरनमेंट को एक अपेक्षाकृत अलग कंटेनर में पैक करता है और यह अनुशंसित विधि है। यदि Docker उपलब्ध नहीं है, तो आप नीचे दिए गए परीक्षित Python कमांड का भी उपयोग कर सकते हैं। Kubernetes कंटेनरों को तैनात करने और प्रबंधित करने के लिए एक प्रणाली है; संबंधित चरणों के लिए इस गाइड के अंत में लिंक किए गए क्विक स्टार्ट को देखें।

आधिकारिक तौर पर अनुशंसित

Docker

• एक docker run कमांड
• ब्राउज़र में 3000 खोलें
• डेटा वॉल्यूम में संग्रहीत है

बस चैट करना चाहते हैं

slim इमेज

• छोटा डाउनलोड आकार
• टैग को :slim में बदलें
• चैट कार्यक्षमता उपलब्ध रहती है

यहाँ कवर नहीं किया गया

दो अन्य विकल्प

• मैनुअल Python इंस्टॉलेशन
• Kubernetes परिनियोजन
• आधिकारिक क्विक स्टार्ट देखें

शुरू करने से पहले, निम्नलिखित तैयार करें:

• Docker इंस्टॉल और चल रहा है।
• केवल आपके द्वारा उपयोग की जाने वाली एक गुप्त स्ट्रिंग। एक उत्पन्न करने के लिए openssl rand -hex 32 चलाएं, फिर इसे WEBUI_SECRET_KEYके रूप में दर्ज करें। इस मान को स्थायी रूप से सहेजें। यदि आप कंटेनर को फिर से बनाते समय इसे बदलते हैं, तो जो उपयोगकर्ता पहले से साइन इन हैं, उन्हें साइन आउट कर दिया जाएगा।
• एक चल रहा OmniProxy इंस्टेंस और उसकी वर्तमान मॉडल सूची से एक मॉडल ID। मॉडल ID एक विशिष्ट मॉडल का चयन करने के लिए उपयोग किया जाने वाला पूर्ण नाम है।

पहली बार इंस्टॉल और लॉन्च करें

एक टर्मिनल खोलें और क्विक स्टार्ट से कमांड चलाएं। पहले your-secret-key को उस गुप्त के साथ बदलें जिसे आपने अभी उत्पन्न किया है:

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY=your-secret-key --name open-webui --restart always ghcr.io/open-webui/open-webui:main

इस कमांड के निम्नलिखित भाग विभिन्न उद्देश्यों की पूर्ति करते हैं:

• -p 3000:8080: आपको इस कंप्यूटर पर पोर्ट 3000 के माध्यम से इंटरफ़ेस खोलने देता है। यदि पोर्ट 3000 पहले से उपयोग में है, तो बाईं ओर की संख्या बदलें।
• -v open-webui:/app/backend/data: चैट, उपयोगकर्ता और सेटिंग्स को डेटा वॉल्यूम में संग्रहीत करता है। डेटा वॉल्यूम कंटेनर के बाहर का एक स्थान है जहाँ डेटा को दीर्घकालिक रूप से बनाए रखा जाता है, इसलिए कंटेनर अपडेट होने के बाद भी इसकी सामग्री बनी रहती है। इस विकल्प को न हटाएं।
• --add-host=host.docker.internal:host-gateway: कंटेनर को इस कंप्यूटर पर चल रही अन्य सेवाओं तक पहुँचने की अनुमति देता है।
• --restart always: कंप्यूटर के रिबूट होने के बाद कंटेनर को फिर से शुरू करता है।

कमांड समाप्त होने के बाद, ब्राउज़र में http://localhost:3000 खोलें और पहला खाता बनाने के लिए ऑन-स्क्रीन निर्देशों का पालन करें।

यदि आपको केवल API के माध्यम से चैट करने की आवश्यकता है, तो आप इमेज टैग को :main से :slimमें बदल सकते हैं। slim एक छोटी इमेज है जिसमें कंटेनर के अंदर स्थानीय स्पीच और एम्बेडिंग मॉडल शामिल नहीं हैं, लेकिन चैट इंटरफ़ेस उपलब्ध रहता है। यदि आपको उन स्थानीय क्षमताओं की आवश्यकता है तो :main का उपयोग करना जारी रखें।

मैनुअल अपडेट के लिए, पहले docker rm -f open-webuiचलाएं, फिर docker pull ghcr.io/open-webui/open-webui:mainचलाएं, और इसे उसी docker run कमांड के साथ पुनरारंभ करें। डेटा वॉल्यूम और WEBUI_SECRET_KEY दोनों को अपरिवर्तित रखें।

यदि Docker उपलब्ध नहीं है

क्विक स्टार्ट एक Python इंस्टॉलेशन विधि भी प्रदान करता है। 2026-10-09 को, Open WebUI v0.11.4 इंस्टॉल करने और एक बातचीत पूरी करने के लिए macOS पर निम्नलिखित कमांड का उपयोग किया गया था। उस समय उस कंप्यूटर पर Docker Desktop इंस्टॉल नहीं था।

DATA_DIR=~/.open-webui uvx --python 3.11 open-webui@latest serve

स्टार्टअप के बाद, ब्राउज़र में http://localhost:8080 खोलें। यह Python इंस्टॉलेशन द्वारा उपयोग किया जाने वाला पोर्ट है, Docker का पोर्ट 3000 नहीं।

पहले स्टार्टअप के दौरान एक एम्बेडिंग मॉडल डाउनलोड किया जाता है, जिसमें कई मिनट लग सकते हैं। एक एम्बेडिंग मॉडल टेक्स्ट को ऐसे डेटा में परिवर्तित करता है जिसे खोजना और मिलान करना आसान होता है। जारी रखने से पहले साइन-इन पेज के दिखाई देने की प्रतीक्षा करें। पहला पंजीकृत खाता प्रशासक बन जाता है। इंटरफ़ेस भाषा सिस्टम भाषा का पालन करती है; इस परीक्षण के दौरान सरलीकृत चीनी (Simplified Chinese) प्रदर्शित की गई थी।

DATA_DIR को एक ऐसी डायरेक्टरी की ओर इशारा करना चाहिए जिसे दीर्घकालिक रूप से बनाए रखा जाएगा और Open WebUI डेटा को संग्रहीत करने के लिए उपयोग किया जाएगा। यदि यह सेट नहीं है, तो डेटा को अस्थायी डायरेक्टरी में संग्रहीत किया जा सकता है और शटडाउन के बाद खो सकता है। यदि WEBUI_SECRET_KEY सेट नहीं है, तो प्रोग्राम वर्तमान डायरेक्टरी में .webui_secret_key लिखता है। इसे उस डायरेक्टरी से शुरू करें जिसे आप बनाए रखना चाहते हैं, या इस वेरिएबल को स्वयं सेट करें।

OmniProxy से कनेक्शन विवरण प्राप्त करें

अपने स्वयं के OmniProxy इंस्टेंस से निम्नलिखित तीन आइटम कॉपी करें:

URL:      https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy from the current OmniProxy model list

URL वह पता है जिसका उपयोग Open WebUI एंडपॉइंट से कनेक्ट करने के लिए करता है और यह /v1पर समाप्त होना चाहिए। इसके बाद /chat/completions न जोड़ें; Open WebUI उस भाग को स्वचालित रूप से जोड़ देता है।

OmniProxy की वर्तमान सूची से पूर्ण मॉडल ID कॉपी करें। यदि ID में एक स्रोत उपसर्ग और स्लैश शामिल है, तो उन्हें भी सुरक्षित रखें। निम्नलिखित दो संक्षिप्त नाम 2026-10-09 तक प्रदाता दस्तावेज़ीकरण के संदर्भ मात्र हैं। यदि वे वर्तमान सूची में नहीं हैं तो उनका उपयोग न करें:

• Claude Sonnet 5.5 के लिए Claude API ID: claude-sonnet-5-5
• Gemini 3.8 Flash के लिए API नाम: gemini-3.8-flash

Open WebUI में प्रदाता कुंजी दर्ज न करें। यदि गेटवे कुंजियों को मान्य नहीं करता है, तो कोई अन्य कुंजी बनाने के बजाय API कुंजी को खाली छोड़ दें।

ब्राउज़र

स्थानीय पोर्ट 3000

• चैट पेज खोलें
• पहले पंजीकरण पूरा करें
• फिर सेटिंग्स खोलें

कंटेनर के अंदर

Open WebUI

• localhost का उपयोग न करें
• इसके बजाय होस्ट मशीन नाम का उपयोग करें
• URL /v1 पर समाप्त होता है

वही कंप्यूटर

OmniProxy

• कुंजी को गेटवे में रखें
• गेटवे की मॉडल सूची का उपयोग करें
• फिर अनुरोध लॉग की समीक्षा करें

यदि मॉडल सेवा होस्ट पर चलती है जबकि Open WebUI Docker कंटेनर में चलता है, तो URL में localhost को host.docker.internalसे बदलें। होस्ट वह कंप्यूटर है जो सीधे Docker चला रहा है। यदि OmniProxy केवल इस कंप्यूटर पर सुनता है, तो URL को http://host.docker.internal:port/v1के रूप में लिखा जा सकता है, जिसमें port को उस पोर्ट से बदलें जिसका उपयोग OmniProxy वास्तव में करता है।

यदि Open WebUI पिछले अनुभाग में Python कमांड के माध्यम से स्थानीय रूप से चल रहा है और OmniProxy भी स्थानीय रूप से चल रहा है, तो पते में 127.0.0.1 या localhost का उपयोग करें। इस मामले में host.docker.internal का उपयोग न करें।

कॉन्फ़िगरेशन दर्ज करें

2026-10-09 को परीक्षित v0.11.4 के सरलीकृत चीनी इंटरफ़ेस में, नाम अंग्रेजी निर्देशों में Settings > Admin > Connections से भिन्न थे। परीक्षित इंटरफ़ेस में दिखाए गए विकल्पों का पालन करें, जिनका अनुवाद नीचे दिया गया है:

1. बायां साइडबार विस्तृत करें।
2. नीचे उपयोगकर्ता मेनू पर क्लिक करें।
3. Settings पर क्लिक करें।
4. नीचे प्रशासक अनुभाग में, External Connections पर क्लिक करें।
5. OpenAI API खोलें।
6. Manage OpenAI API Connections के दाईं ओर + पर क्लिक करें।
7. Edit Connection संवाद में, URL दर्ज करें जो /v1पर समाप्त होता है। API प्रकार को Chat Completions पर सेट रखें।
8. Authentication Method को Key (Bearer) पर सेट रखें। Bearer प्रमाणीकरण पहचान सत्यापन के लिए अनुरोध में API कुंजी रखता है। यदि OmniProxy ने आपको एक कुंजी दी है, तो उसे API Key के अंतर्गत दर्ज करें। यदि गेटवे कुंजियों को मान्य नहीं करता है, तो इस फ़ील्ड को खाली छोड़ दें। 2026-10-09 को, फ़ील्ड को खाली छोड़ने के साथ सत्यापन और एक बातचीत दोनों सफल रहे।
9. URL के बगल में Verify Connection पर क्लिक करें। यदि OmniProxy /modelsप्रदान करता है, तो मॉडल सूची यहाँ प्राप्त की जाएगी।
10. Advanced खोलें। यदि Model ID को खाली छोड़ दिया जाता है, तो उस पते पर /models द्वारा लौटाए गए सभी मॉडलों का उपयोग किया जाएगा। केवल यदि सत्यापन विफल हो जाता है, तो Add Model ID के अंतर्गत सूची से एक पूर्ण ID दर्ज करें, फिर Add पर क्लिक करें। प्रत्येक ID को केवल एक बार जोड़ें; अग्रणी और अनुगामी रिक्त स्थान हटा दिए जाते हैं।
11. इस विंडो में Save पर क्लिक करें, फिर External Connections पेज के निचले-दाएं कोने में Save पर क्लिक करें।

अकेले कॉन्फ़िगरेशन को सहेजना सत्यापन को प्रतिस्थापित नहीं करता है। Verify Connection दूसरी सेवा के /models एंडपॉइंट का अनुरोध करता है, जो उपलब्ध मॉडलों को सूचीबद्ध करता है। कुछ सेवाएं यह एंडपॉइंट प्रदान नहीं करती हैं, इसलिए सत्यापन एक त्रुटि की रिपोर्ट कर सकता है, भले ही चैट अभी भी काम कर सके। उस स्थिति में, मॉडल ID को मैन्युअल रूप से जोड़ें।

वास्तविक कार्य के साथ सत्यापित करें

चैट पेज पर वापस जाएं, इनपुट बॉक्स के बगल में मॉडल मेनू खोलें, और OmniProxy सूची से पूर्ण ID चुनें। एक बहुत छोटा संदेश भेजें, जैसे कि इसे केवल एक शब्द के साथ उत्तर देने के लिए कहना। चैट बॉक्स में वास्तव में एक प्रतिक्रिया दिखाई देनी चाहिए।

2026-10-09 को, यह बातचीत v0.11.4 के Python इंस्टॉलेशन का उपयोग करके पूरी की गई थी। Docker अनुशंसित विधि बनी हुई है, लेकिन परीक्षण को Docker में दोहराया नहीं गया था।

इसके बाद, OmniProxy के अनुरोध लॉग खोलें और इस अनुरोध के लिए स्रोत और मॉडल ID की पुष्टि करें। केवल एक सफल सहेज देखना, या केवल मेनू में मॉडल देखना, पूर्णता के रूप में नहीं गिना जाता है।

इंटरफ़ेस

मॉडल का चयन किया जा सकता है

• कनेक्शन सहेजा गया है
• मॉडल सूची में दिखाई देता है
• एक छोटा प्रश्न भेजें

प्रतिक्रिया

चैट बॉक्स एक उत्तर दिखाता है

• यह एक खाली संदेश नहीं है
• यह एक कनेक्शन त्रुटि नहीं है
• किसी अन्य मॉडल के साथ फिर से प्रयास करें

लॉग

गेटवे में दिखाई देता है

• स्रोत यह कनेक्शन है
• मॉडल ID मेल खाता है
• पेज पर कोई कुंजी दर्ज नहीं की गई थी

सामान्य त्रुटियां

• localhost या 127.0.0.1 का उपयोग कंटेनर के अंदर किया गया था: ये पते कंटेनर को ही इंगित करते हैं, होस्ट को नहीं। पते को host.docker.internal में बदलें और पुष्टि करें कि स्टार्टअप कमांड में --add-host=host.docker.internal:host-gatewayशामिल है। जब Open WebUI कंटेनर में नहीं चल रहा हो तो इसके विपरीत लागू होता है: इसके बजाय स्थानीय पते का उपयोग करें।
• ब्राउज़र पेज नहीं खोल सकता: Docker के लिए, पोर्ट 3000 की जांच करें; Python के लिए, पोर्ट 8080 की जांच करें। पहले स्टार्टअप के दौरान, एम्बेडिंग मॉडल डाउनलोड के समाप्त होने की प्रतीक्षा करें। आप यह पुष्टि करने के लिए docker ps का उपयोग कर सकते हैं कि क्या कंटेनर चल रहा है। यदि पोर्ट 3000 पहले से उपयोग में है, तो -pके बाईं ओर पोर्ट बदलें।
• मॉडल मेनू में ID प्रदाता के संक्षिप्त नाम से लंबी है: मेनू से पूर्ण ID का उपयोग करें, जिसमें कोई भी स्लैश शामिल है।
• अपडेट के बाद हर कोई साइन आउट हो गया है: WEBUI_SECRET_KEY बदल गया। पहली बार उत्पन्न गुप्त का उपयोग करके पुनरारंभ करें।
• Verify Connection विफल रहता है: पहले Advanced के अंतर्गत मैन्युअल रूप से मॉडल ID जोड़ें, फिर इसे एक वास्तविक एक-वाक्य चैट के साथ पुष्टि करें। कुछ सेवाएं /modelsप्रदान नहीं करती हैं, इसलिए जब सत्यापन त्रुटि की रिपोर्ट करता है तो चैट अभी भी काम कर सकती है।
• मॉडल मौजूद नहीं है: पुराने नाम का उपयोग जारी रखने के बजाय OmniProxy की वर्तमान सूची से ID को फिर से कॉपी करें।

आधिकारिक संदर्भ

इंस्टॉलेशन कमांड के लिए, Open WebUI Quick Start देखें। कनेक्शन चरणों के लिए, OpenAI-compatible connection instructions देखें। उदाहरणों में उपयोग की गई मॉडल ID के लिए, Claude model overview और Gemini model list देखें।

अपनी स्वयं की OmniProxy कॉन्फ़िगरेशन से प्रत्येक प्लेसहोल्डर को मान से बदलें। कभी भी एक वास्तविक कुंजी प्रकाशित न करें।

एक सहेजा गया परिणाम या HTTP 200 अकेले पूरी एजेंट संगतता को साबित नहीं करता है। OmniProxy के कॉल रिकॉर्ड में स्रोत और मॉडल जांचें।

आधिकारिक स्रोत · Open WebUI ↗