Skip to main content
Reference value for .env file.

​
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

​
Workspace Model (Optional)

  • CREATE_CUSTOM_WORKSPACE_MODEL: True installs the bundled model, or set a file name from models/ to install that file
  • OWUI_MODEL_PROMPT: replaces the model’s system prompt
  • OWUI_MODEL_PROMPT_APPEND: appends text to the model’s system prompt, separated by a blank line
The prompt variables apply only when CREATE_CUSTOM_WORKSPACE_MODEL installs a model. See Workspace Models for details.
This installs only during first-start initialization — the setup that runs only once, the first time the container boots, gated on a marker file. Setting CREATE_CUSTOM_WORKSPACE_MODEL on an already-running instance does not install it retroactively.

​
Runtime

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

​
Minimal Example