Skip to content

docs: correct the Python tabs' data directory, and document the serve options, secret key file, and single-worker migrations - #1420

Merged
silentoplayz merged 1 commit into
open-webui:mainfrom
silentoplayz:docs/python-install-tabs
Sep 26, 2026
Merged

silentoplayz merged 1 commit into
open-webui:mainfrom
silentoplayz:docs/python-install-tabs

Conversation

@silentoplayz

@silentoplayz silentoplayz commented Sep 18, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

I compared the Python install tabs with the CLI, the env code and the build hook.

  • The data directory: three of the four uninstall sections said the data lives in ~/.open-webui, and the fourth deleted that folder. When started with open-webui serve, it defaults to open_webui/data inside the package, so removing the environment removes it. ~/.open-webui only holds data if DATA_DIR was set to it.
  • The Pip tab now names --host and --port. It says that open-webui serve writes .webui_secret_key in the directory it is started from, so starting elsewhere signs everyone out. It also says that installing from source or a Git URL runs the build hook, which needs Node.js and npm.
  • The multi-worker update warning now notes that migrations run in every process, and that ENABLE_DB_MIGRATIONS=false can keep extra replicas (not the workers of one open-webui serve process) from running them.

Related issue or discussion

None.

Checklist

  • I have reviewed the relevant documentation and matched the existing style.
  • This PR meets Open WebUI's contribution standards: it is accurate, relevant to users, narrowly scoped, maintainable, and not promotional content, advertising, lead generation, SEO placement, or a request to list a product, service, provider, integration, gateway, tool, or company primarily for visibility.
  • I understand that PRs that do not meet these standards may be closed without review and will not be merged. Repeated, low-quality, off-topic, promotional, or intentionally misleading submissions may result in the contributor being blocked from future participation in Open WebUI repositories.

Notes for reviewers

Sources on dev: env.py (DATA_DIR with FROM_INIT_PY), open_webui/__init__.py (serve, KEY_FILE), hatch_build.py, and config.py (run_migrations gated on ENABLE_DB_MIGRATIONS).

@silentoplayz
silentoplayz force-pushed the docs/python-install-tabs branch from 371490f to adc0efc Compare September 25, 2026 05:17
… options, secret key file, and single-worker migrations
@silentoplayz
silentoplayz force-pushed the docs/python-install-tabs branch from adc0efc to 1873e94 Compare September 25, 2026 05:41
@silentoplayz
silentoplayz merged commit 199ed06 into open-webui:main Sep 26, 2026
1 check passed
@silentoplayz
silentoplayz deleted the docs/python-install-tabs branch September 26, 2026 09:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant