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 ਨੂੰ, 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 ਨਹੀਂ।

ਪਹਿਲੀ ਸ਼ੁਰੂਆਤ ਦੌਰਾਨ ਇੱਕ ਐਮਬੈਡਿੰਗ ਮਾਡਲ ਡਾਊਨਲੋਡ ਕੀਤਾ ਜਾਂਦਾ ਹੈ, ਜਿਸ ਵਿੱਚ ਕਈ ਮਿੰਟ ਲੱਗ ਸਕਦੇ ਹਨ। ਇੱਕ ਐਮਬੈਡਿੰਗ ਮਾਡਲ ਟੈਕਸਟ ਨੂੰ ਡੇਟਾ ਵਿੱਚ ਬਦਲਦਾ ਹੈ ਜੋ ਖੋਜਣ ਅਤੇ ਮੇਲ ਕਰਨ ਵਿੱਚ ਆਸਾਨ ਹੁੰਦਾ ਹੈ। ਜਾਰੀ ਰੱਖਣ ਤੋਂ ਪਹਿਲਾਂ ਸਾਈਨ-ਇਨ ਪੰਨੇ ਦੇ ਦਿਖਾਈ ਦੇਣ ਦੀ ਉਡੀਕ ਕਰੋ। ਪਹਿਲਾ ਰਜਿਸਟਰਡ ਖਾਤਾ ਐਡਮਿਨਿਸਟ੍ਰੇਟਰ ਬਣ ਜਾਂਦਾ ਹੈ। ਇੰਟਰਫੇਸ ਭਾਸ਼ਾ ਸਿਸਟਮ ਭਾਸ਼ਾ ਦੀ ਪਾਲਣਾ ਕਰਦੀ ਹੈ; ਇਸ ਟੈਸਟ ਦੌਰਾਨ ਸਰਲੀਕ੍ਰਿਤ ਚੀਨੀ ਪ੍ਰਦਰਸ਼ਿਤ ਕੀਤੀ ਗਈ ਸੀ।

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 ↗