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 इंस्टन्स आणि त्याच्या सध्याच्या मॉडेल यादीतून एक मॉडेल आयडी. मॉडेल आयडी हे विशिष्ट मॉडेल निवडण्यासाठी वापरले जाणारे पूर्ण नाव आहे.

प्रथमच स्थापित आणि लाँच करा

टर्मिनल उघडा आणि क्विक स्टार्टमधील कमांड चालवा. प्रथम 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 रोजी, macOS वर Open WebUI v0.11.4 स्थापित करण्यासाठी आणि एक संभाषण पूर्ण करण्यासाठी खालील कमांड वापरली गेली. त्या वेळी त्या संगणकावर 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 च्या सध्याच्या यादीतून पूर्ण मॉडेल आयडी कॉपी करा. जर आयडीमध्ये स्रोत उपसर्ग आणि स्लॅश समाविष्ट असेल, तर ते देखील जतन करा. खालील दोन लहान नावे केवळ 2026-10-09 पर्यंतच्या प्रदाता दस्तऐवजीकरणातील संदर्भ आहेत. जर ती सध्याच्या यादीत नसतील तर त्यांचा वापर करू नका:

• Claude Sonnet 5.5 साठी Claude API आयडी: 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 अंतर्गत प्रविष्ट करा, त्यानंतर Add वर क्लिक करा. प्रत्येक आयडी फक्त एकदाच जोडा; सुरुवातीची आणि शेवटची जागा काढली जाते.
11. या विंडोमध्ये Save वर क्लिक करा, त्यानंतर External Connections पृष्ठाच्या खालच्या उजव्या कोपऱ्यात Save वर क्लिक करा.

केवळ कॉन्फिगरेशन सेव्ह केल्याने पडताळणीची जागा घेत नाही. Verify Connection दुसऱ्या सेवेच्या /models एंडपॉईंटची विनंती करते, जे उपलब्ध मॉडेल्सची यादी करते. काही सेवा हा एंडपॉईंट प्रदान करत नाहीत, त्यामुळे चॅट अजूनही काम करत असतानाही पडताळणी त्रुटी दर्शवू शकते. अशा परिस्थितीत, मॉडेल आयडी मॅन्युअली जोडा.

वास्तविक कार्याची पडताळणी करा

चॅट पृष्ठावर परत या, इनपुट बॉक्सच्या शेजारील मॉडेल मेनू उघडा आणि OmniProxy यादीतून पूर्ण आयडी निवडा. एक अतिशय लहान संदेश पाठवा, जसे की त्याला फक्त एका शब्दात उत्तर देण्यास सांगणे. चॅट बॉक्समध्ये प्रतिसाद खरोखर दिसला पाहिजे.

2026-10-09 रोजी, हे संभाषण v0.11.4 च्या Python इंस्टॉलेशनचा वापर करून पूर्ण केले गेले. Docker ही शिफारस केलेली पद्धत आहे, परंतु चाचणी Docker मध्ये पुन्हा केली गेली नाही.

पुढे, OmniProxy च्या विनंती लॉग्स उघडा आणि या विनंतीसाठी स्रोत आणि मॉडेल आयडी कन्फर्म करा. फक्त यशस्वी सेव्ह पाहणे, किंवा मेनूमध्ये फक्त मॉडेल पाहणे म्हणजे पूर्णता होत नाही.

इंटरफेस

मॉडेल निवडले जाऊ शकते

• Connections सेव्ह केले गेले आहे
• मॉडेल यादीमध्ये दिसते
• लहान प्रश्न पाठवा

प्रतिसाद

चॅट बॉक्समध्ये उत्तर दिसते

• तो रिकामा संदेश नाही
• ती कनेक्शन त्रुटी नाही
• दुसऱ्या मॉडेलसह पुन्हा प्रयत्न करा

लॉग्स

गेटवेमध्ये दृश्यमान

• स्रोत हे कनेक्शन आहे
• मॉडेल आयडी जुळतो
• पृष्ठावर कोणतीही की प्रविष्ट केली गेली नाही

सामान्य त्रुटी

• 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च्या डाव्या बाजूला पोर्ट बदला.
• मॉडेल मेनू मधील आयडी प्रदात्याच्या लहान नावापेक्षा मोठा आहे: मेनूमधील पूर्ण आयडी वापरा, कोणत्याही स्लॅशसह.
• अपडेटनंतर प्रत्येकजण साइन आउट झाला आहे: WEBUI_SECRET_KEY बदलले. पहिल्यांदा जनरेट केलेल्या गुप्ततेचा वापर करून रीस्टार्ट करा.
• Verify Connection अयशस्वी होते: प्रथम Advanced अंतर्गत मॉडेल आयडी मॅन्युअली जोडा, त्यानंतर एका वाक्याच्या वास्तविक चॅटसह ते कन्फर्म करा. काही सेवा /modelsप्रदान करत नाहीत, त्यामुळे पडताळणी त्रुटी दर्शवत असतानाही चॅट काम करू शकते.
• मॉडेल अस्तित्वात नाही: जुने नाव वापरणे सुरू ठेवण्याऐवजी OmniProxy च्या सध्याच्या यादीतून आयडी पुन्हा कॉपी करा.

अधिकृत संदर्भ

इंस्टॉलेशन कमांड्ससाठी, Open WebUI Quick Start पहा. कनेक्शन पायऱ्यांसाठी, OpenAI-compatible connection instructions पहा. उदाहरणांमध्ये वापरलेल्या मॉडेल आयडीसाठी, Claude model overview आणि Gemini model list पहा.

तुमच्या स्वतःच्या OmniProxy कॉन्फिगरेशनमधील प्रत्येक जागादार मूल्य बदला. वास्तविक की कधीही प्रकाशित करू नका.

संवर्धित परिणाम किंवा HTTP 200 फक्त पूर्ण एजंट सुसंगतता सिद्ध करत नाही. OmniProxy च्या कॉल रेकॉर्डमध्ये स्रोत आणि मॉडेल तपासा.

अधिकृत स्रोत · Open WebUI ↗