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 मध्ये प्रदाता की (key) प्रविष्ट करू नका. जर गेटवे की (key) सत्यापित करत नसेल, तर दुसरी की (key) शोधण्याऐवजी API की (key) रिकामी सोडा.

ब्राउझर

स्थानिक पोर्ट 3000

• चॅट पेज उघडा
• प्रथम नोंदणी पूर्ण करा
• त्यानंतर सेटिंग्ज उघडा

कंटेनरच्या आत

Open WebUI

• localhost वापरू नका
• त्याऐवजी होस्ट मशीनचे नाव वापरा
• URL /v1 ने संपते

समान संगणक

OmniProxy

• गेटवेमध्ये की (key) ठेवा
• गेटवेची मॉडेल यादी वापरा
• त्यानंतर विनंती लॉग्सचे पुनरावलोकन करा

जर मॉडेल सेवा होस्टवर चालत असेल तर Open WebUI Docker कंटेनरमध्ये चालत असेल, तर बदला localhost URL मधील 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 की (key) ठेवते. जर OmniProxy ने तुम्हाला की (key) दिली असेल, तर ती API Key अंतर्गत प्रविष्ट करा. जर गेटवे की (key) सत्यापित करत नसेल, तर हे क्षेत्र रिकामे सोडा. 2026-10-09 रोजी, फील्ड रिकामे सोडून पडताळणी आणि एक संभाषण दोन्ही यशस्वी झाले.
9. URL च्या शेजारी Verify Connection वर क्लिक करा. जर OmniProxy प्रदान करत असेल /models, मॉडेल यादी येथे पुनर्प्राप्त केली जाईल.
10. Advanced उघडा. जर Model ID रिकामे सोडले असेल, तर त्या पत्त्यावर /models द्वारे परत केलेली सर्व मॉडेल्स वापरली जातील. फक्त जर पडताळणी अयशस्वी झाली, तर यादीतील पूर्ण ID Add Model 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 तपासा. फक्त यशस्वी सेव्ह पाहणे, किंवा मेनूमध्ये फक्त मॉडेल पाहणे म्हणजे पूर्ण झाले असे होत नाही.

इंटरफेस

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

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

प्रतिसाद

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

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

लॉग्स

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

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

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

• 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 ↗