Skip to content

openwebui

Version 2026.144.1443
Repo superproject

Open WebUI LLM chat front-end with an auto-configuring entrypoint, served as a supervised HTTP service on port 8080. Installs the Open WebUI server (the open-webui PyPI package via pixi) and copies a bash auto-config entrypoint to ${HOME}/.local/bin/openwebui-entrypoint (mode 0755). A supervised system service runs that entrypoint, which wires up LLM providers from env/secrets (OpenRouter, Ollama Cloud, direct OpenAI, local Ollama, MCP servers, and Jupyter code execution), enforces mandatory admin credentials (WEBUI_ADMIN_EMAIL + WEBUI_ADMIN_PASSWORD), reads the auto-generated WEBUI_SECRET_KEY, then exec’s open-webui serve on port 8080. Every fact below is observable: the installed executable entrypoint, the running service, the admin email injected into its environment, and the HTTP 200 the web UI returns on its published port.

  • openwebui

This candy’s plan: — the runnable spec charly check executes against a live deployment. check: steps are idempotent probes; run: steps change state.

Intent Step
run mkdir=${HOME}/.local/bin
run copy=openwebui-entrypoint
check the auto-config entrypoint script is present and executable at ${HOME}/.local/bin/openwebui-entrypoint
check the openwebui service is running under the init system
check the Open WebUI web interface answers HTTP 200 on the published port
check the mandatory admin email is injected into the running service environment
agent-check the rendered landing page presents the Open WebUI sign-in experience for the auto-provisioned admin account, ready to start an LLM chat
check addr=127.0.0.1:${HOST_PORT:8080}