Environment Variables (Frontend)

​

URL and Port

• WEBUI_URL: public URL of OpenWebUI (example: http://localhost:3000)
• HTTP_WEB_PORT: host port mapped to OpenWebUI container
• WEBUI_SECRET_KEY: app secret key (generate strong random value)

​

Database

• POSTGRES_USER: Postgres username
• POSTGRES_PASSWORD: Postgres password
• POSTGRES_DB: Postgres database name
• POSTGRES_HOST: Postgres host/service name
• POSTGRES_PORT: Postgres port

​

Admin Provisioning

• X_WEBUI_ADMIN_USER: initial admin display name
• X_WEBUI_ADMIN_EMAIL: initial admin email
• X_WEBUI_ADMIN_PASS: initial admin password
• WEBUI_AUTH: enable web authentication (True/False)
• ENABLE_SIGNUP: allow signup on first boot (True/False)
• ENABLE_LOGIN_FORM: enable login form (True/False)

Note: keep ENABLE_SIGNUP=True on first start so admin account auto-provisioning works. After first boot, you can disable it to run in single-user or private modes.

​

OpenAI-Compatible Provider (Optional)

• ENABLE_OPENAI_API: auto-provision provider settings (True/False)
• OPENAI_API_BASE_URL: provider base URL (example: https://openrouter.ai/api/v1)
• OPENAI_API_KEY: provider API key
• OPENAI_DEFAULT_MODEL: default model ID

​

Runtime

• ENV: runtime mode (example: dev)
• UVICORN_WORKERS: number of Uvicorn workers
• USER_AGENT: outgoing user agent string

​

Minimal Example

WEBUI_URL=http://localhost:3000
HTTP_WEB_PORT=3000
WEBUI_SECRET_KEY=<random-hex>

POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
POSTGRES_DB=openwebui
POSTGRES_HOST=postgres
POSTGRES_PORT=5432

X_WEBUI_ADMIN_USER=Admin
X_WEBUI_ADMIN_EMAIL=admin@example123.com
X_WEBUI_ADMIN_PASS=<strong-password>
WEBUI_AUTH=True
ENABLE_SIGNUP=True
ENABLE_LOGIN_FORM=True

ENABLE_OPENAI_API=True
OPENAI_API_BASE_URL=https://openrouter.ai/api/v1
OPENAI_API_KEY=<api-key>
OPENAI_DEFAULT_MODEL=openai/gpt-4.1-nano

ENV=dev
UVICORN_WORKERS=1
USER_AGENT=rag-of-all-trades+openwebui/0.6.5