Open WebUI کی تنصیب اور OmniProxy کی کنفیگریشن

Open WebUI ایک سیلف ہوسٹڈ چیٹ انٹرفیس ہے جسے آپ کے اپنے کمپیوٹر یا سرور پر انسٹال کیا جا سکتا ہے اور یہ مکمل طور پر آف لائن بھی چل سکتا ہے۔ یہ کسی ایک ماڈل فراہم کنندہ سے منسلک نہیں ہے: یہ Ollama جیسے ٹولز سے منسلک ہو سکتا ہے جو ماڈلز کو مقامی طور پر چلاتے ہیں، نیز OpenAI-مطابقت پذیر اینڈ پوائنٹس—ایسے پتے جو اسی درخواست فارمیٹ کا استعمال کرتے ہوئے ماڈل سروسز فراہم کرتے ہیں۔ یہ آپ کو ایک ہی ونڈو میں مقامی اور کلاؤڈ ماڈلز کے درمیان سوئچ کرنے دیتا ہے۔

یہ ٹیموں اور تنظیموں کے طویل مدتی استعمال کے لیے موزوں ہے۔ وہ صلاحیتیں جو تیزی سے اپ ڈیٹس حاصل کرتی ہیں وہ سب سے پہلے Computer میں ظاہر ہوتی ہیں، وہ پروڈکٹ جسے Open WebUI نئی خصوصیات کو آزمانے کے لیے استعمال کرتا ہے۔

شروع کرنے سے پہلے

Open WebUI macOS، Linux، اور Windows پر دستیاب ہے۔ آپ اسے Docker، Python، یا Kubernetes کا استعمال کرتے ہوئے انسٹال کر سکتے ہیں۔ Docker ایپلی کیشن اور اس کے رن ٹائم ماحول کو ایک نسبتاً الگ تھلگ کنٹینر میں پیک کرتا ہے اور یہ تجویز کردہ طریقہ ہے۔ اگر Docker دستیاب نہیں ہے، تو آپ نیچے دی گئی ٹیسٹ شدہ Python کمانڈ بھی استعمال کر سکتے ہیں۔ Kubernetes کنٹینرز کو تعینات کرنے اور ان کا انتظام کرنے کا ایک نظام ہے؛ متعلقہ مراحل کے لیے اس گائیڈ کے آخر میں لنک کردہ Quick Start دیکھیں۔

سرکاری طور پر تجویز کردہ

Docker

• ایک docker run کمانڈ
• براؤزر میں 3000 کھولیں
• ڈیٹا والیوم میں محفوظ ہے

صرف چیٹ کرنا چاہتے ہیں

slim امیج

• چھوٹا ڈاؤن لوڈ سائز
• ٹیگ کو :slim میں تبدیل کریں
• چیٹ کی فعالیت دستیاب رہتی ہے

یہاں شامل نہیں ہے

دو دیگر آپشنز

• دستی Python انسٹالیشن
• Kubernetes تعیناتی
• سرکاری Quick Start دیکھیں

شروع کرنے سے پہلے، درج ذیل تیار کریں:

• Docker انسٹال اور چل رہا ہے۔
• ایک خفیہ سٹرنگ جو صرف آپ استعمال کرتے ہیں۔ ایک بنانے کے لیے openssl rand -hex 32 چلائیں، پھر اسے WEBUI_SECRET_KEY کے طور پر درج کریں۔ اس ویلیو کو مستقل طور پر محفوظ کریں۔ اگر آپ کنٹینر کو دوبارہ بناتے وقت اسے تبدیل کرتے ہیں، تو جو صارفین پہلے سے سائن ان ہیں وہ سائن آؤٹ ہو جائیں گے۔
• ایک چلتا ہوا OmniProxy انسٹینس اور اس کی موجودہ ماڈل لسٹ سے ایک ماڈل ID۔ ماڈل ID ایک مخصوص ماڈل کو منتخب کرنے کے لیے استعمال ہونے والا مکمل نام ہے۔

پہلی بار انسٹال اور لانچ کریں

ایک ٹرمینل کھولیں اور Quick Start سے کمانڈ چلائیں۔ پہلے 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 دستیاب نہیں ہے

Quick Start ایک 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 کی موجودہ لسٹ سے مکمل ماڈل 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 کے Simplified Chinese انٹرفیس میں، نام انگریزی ہدایات میں Settings > Admin > Connections سے مختلف تھے۔ ٹیسٹ کیے گئے انٹرفیس میں دکھائے گئے آپشنز پر عمل کریں، جن کا ترجمہ نیچے دیا گیا ہے:

1. بائیں سائڈبار کو پھیلائیں۔
2. نیچے صارف مینو پر کلک کریں۔
3. Settings پر کلک کریں۔
4. نیچے ایڈمنسٹریٹر سیکشن میں، External Connections پر کلک کریں۔
5. OpenAI API کھولیں۔
6. Manage OpenAI API Connections کے دائیں جانب + پر کلک کریں۔
7. Edit Connection ڈائیلاگ میں، /v1 پر ختم ہونے والا URL درج کریں۔ 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 کی تصدیق کریں۔ صرف ایک کامیاب سیو دیکھنا، یا مینو میں صرف ماڈل دیکھنا، تکمیل کے طور پر شمار نہیں ہوتا۔

انٹرفیس

ماڈل منتخب کیا جا سکتا ہے

• Connections محفوظ ہو چکے ہیں
• ماڈل لسٹ میں ظاہر ہوتا ہے
• مختصر سوال بھیجیں

جواب

چیٹ باکس جواب دکھاتا ہے

• یہ خالی پیغام نہیں ہے
• یہ کنکشن کی غلطی نہیں ہے
• کسی اور ماڈل کے ساتھ دوبارہ کوشش کریں

لاگز

گیٹ وے میں نظر آتا ہے

• ذریعہ یہ کنکشن ہے
• ماڈل 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 دیکھیں۔ مثالوں میں استعمال ہونے والی ماڈل IDs کے لیے، Claude model overview اور Gemini model list دیکھیں۔

اپنے ذاتی OmniProxy ترتیب سے ہر پلس ہولڈر کو ویلیوز سے تبدیل کریں۔ کبھی بھی حقیقی کنج شائع نہ کریں۔

محفوظ شدہ نتیجہ یا HTTP 200 اکیلے مکمل ایجنٹ مطابقت ثابت نہیں کرتا۔ OmniProxy کی کال ریکارڈ میں ذریعہ اور ماڈل چیک کریں۔

سرکاری ذرائع · Open WebUI ↗