Component
core/ai-agent/open-webui
A self-hosted Open WebUI installation — the browser platform a person holds conversations in, and the tier that turns a bare model endpoint into a working assistant surface. It reaches its model through the `model` uses-socket and calls it as an OpenAI-compatible API, adding retrieval over the documents a user loads, tool invocation over the tool servers an administrator registers, and per-user and per-group access control. The conversation loop is always started by a person: the platform runs no background loop of its own. It keeps its accounts, conversations and document index on one durable volume, so a realization gives it storage that outlives its container. It exports its host, port and protocol, which is how an ingress tier publishes it. On Kubernetes there are two realizations and the Manifest chooses between them. `open-webui` synthesizes the platform as a workload and fetches nothing, so it is the one to reach for where the build must complete with no chart repository reachable. `open-webui-chart` renders the platform's own Helm chart, which additionally carries single sign-on against several identity providers and per-component log levels, both set through `infra.overrides`, so reach for it where a chart repository is reachable at build time.
Procedencia
- Digest del contenido
- sha256:76dfc1edab6c8fb232ada4258a0c23a92dd990face11a3088ede03670eb6c02a
- Publicado
- 2026-11-10T10:08:33Z
- Identidad de firma
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Firma
- Oficialapplication/vnd.dev.sigstore.bundle.v0.3+json
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
sha256:30887ad87efb6bf3e287d36426d33d0ae812eb83b43a53e6eebe133f9268d6d0
Referencia en esta versión
oci://hub.aggrega.ai/component/core/ai-agent/open-webui:1.0.0Parámetros del desarrollador
Valores que el desarrollador establece en el Aggregate.
Extiende BaseComponents#/schemas/BaseAgentParameter
| Nombre | Tipo | Predeterminado | Obligatorio | Descripción |
|---|---|---|---|---|
| instance_title | string | Open WebUI | no | Name the platform presents in the browser title and the interface header. Two installations reachable by the same people tell themselves apart by carrying different titles. |
| enable_signup | boolean | false | no | Whether a visitor who is not yet a user may create an account from the sign-in page. Left off, accounts are created only by an administrator, which is the posture an installation reachable beyond its own team wants. |
| default_user_role | string (pending | user | admin) | pending | no | Role a newly created account receives. The default withholds access until an administrator grants it, so enabling signup does not by itself grant anyone the platform. |
| enable_web_search | boolean | false | no | Whether the platform offers web search as a retrieval source inside a conversation. Left off, retrieval draws only on documents a user loaded, so no conversation content reaches a search provider. |
Dimensionamiento del operador
Dimensionamiento de la infraestructura que el operador ajusta para cada entorno.
| Nombre | Tipo | Predeterminado | Obligatorio | Descripción |
|---|---|---|---|---|
| port | integer (min 1024, max 65535) | 8080 | no | Listen port the platform serves its interface and API on, and the port consumers connect to. Most operators should omit this and let the Recipe assign the default (8080). |
| engine_version | string | v0.11.1 | no | Open WebUI container image tag. Selects the image tag on the synthesized platform container; the chart-backed realization pins its own image tag. |
| source_version | string | — | no | Version of the Helm chart the chart-backed realization pulls. Read only by that realization; the workload-synthesis realization pulls no source artifact and ignores it. Changing it away from the Recipe's default does not guarantee value-mapping compatibility with the new chart. |
| storage | object | — | no | — |
| external_base_url | string | no | Externally reachable base URL of the installation, as a browser sees it — the address the ingress tier publishes. The platform composes the links it emits from it, which is what makes a shared conversation link resolve from outside the cluster. Left empty, no link base is set and the platform derives each address from the incoming request, which suits an installation reached only in-cluster. | |
| compute | object | — | no | — |
| overrides | object (open) | — | no | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Contrato de salida
Valores que este componente publica para los consumidores a través de la topología uses.
| Nombre | Tipo | Predeterminado | Obligatorio | Descripción |
|---|---|---|---|---|
| host | string | — | sí | In-cluster DNS name of the Service serving the chat interface and its API. The ingress tier points its upstream at this name. |
| port | integer | — | sí | TCP port that Service serves the interface and API on. It follows the port an operator set in the Release, so a consumer reads it rather than assuming a default. |
| protocol | string | — | no | URL scheme to reach `host` and `port` over, which a consumer composes its base URL on. |
Sockets uses
Los sockets de dependencia a través de los cuales se conecta este componente. El destino de cada conexión cableada a través de un socket debe satisfacer su selector de etiquetas, y cada conexión puede llevar un acoplamiento en los slots que declara el socket. Cada conexión que el Aggregate o la Release cablea a través del socket debe llenar los slots obligatorios.
model
- Selector
- component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
- Inyección
- —
Slots que cada conexión a través de este socket puede llenar
| Slot | Selector | Obligatorio | Inyección | Sensible | Descripción |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | no | env | sí | Optional credential the platform presents to the model this connection reaches. Unattached, the Recipe delivers no key at all, which suits an in-cluster endpoint that authenticates callers by network position rather than by key. |
Slots de acoplamiento
Puntos de enlace con nombre en los que una Feature se acopla a este componente. El selector de un slot restringe qué Feature puede llenarlo y su lista inject indica cómo puede entregarse el material de la Feature. Un slot obligatorio debe estar enlazado en cada instancia, mediante un acoplamiento en la instancia o en un ámbito superior, y un slot sensible se declara para manejar material secreto. Una Feature también puede acoplarse con un nombre que ningún slot declara.
| Slot | Selector | Obligatorio | Inyección | Sensible | Descripción |
|---|---|---|---|---|---|
| session_secret | feature.aggrega.ai/kind=secret | sí | env | sí | Required secret the platform signs its session tokens with. There is no default: the build halts when nothing fills this slot. Leaving the variable unset instead, so the platform mints a key of its own, is a bootstrap convenience rather than a credential-rotation system: the minted key does not survive a restart, so each restart invalidates every sign-in then active. |
Lista de permitidos de autoinyección
No se declararon canales de autoinyección.
Relaciones
Aristas tipadas hacia y desde otras entidades publicadas. Una referencia sin un destino publicado se muestra como una arista rota en lugar de como un enlace.
Usa
- usausa el socket «model»
component.aggrega.ai/category in (ai-model, gateway), model.aggrega.ai/api
Slots de acoplamiento: credential
core/ai-model/ai21 v1.0.0 →core/ai-model/anthropic v1.0.0 →core/ai-model/azure-managed v1.0.0 →core/ai-model/azure-openai v1.0.0 →core/ai-model/azure-openai-embedding v1.0.0 →core/ai-model/bedrock v1.0.0 →core/ai-model/bedrock-embedding v1.0.0 →core/ai-model/cohere v1.0.0 →core/ai-model/databricks v1.0.0 →core/ai-model/docker-model-runner v1.0.0 →core/ai-model/gemini v1.0.0 →core/ai-model/huggingface v1.0.0 →core/ai-model/litellm v1.0.0 →core/ai-model/mistral v1.0.0 →core/ai-model/nvidia-api v1.0.0 →core/ai-model/nvidia-nim v1.0.0 →core/ai-model/ollama v1.0.0 →core/ai-model/openai v1.0.0 →core/ai-model/openai-compatible v1.0.0 →core/ai-model/openai-embedding v1.0.0 →core/ai-model/replicate v1.0.0 →core/ai-model/sagemaker v1.0.0 →core/ai-model/tei v1.0.0 →core/ai-model/tgi v1.0.0 →core/ai-model/vertex-ai v1.0.0 →core/ai-model/vertex-ai-embedding v1.0.0 →core/ai-model/vllm v1.0.0 →core/gateway/agentgateway v1.0.0 →core/gateway/apisix v1.0.0 →core/gateway/envoy-gateway v1.0.0 →core/gateway/higress v1.0.0 →core/gateway/kong v1.0.0 →core/gateway/kong-enterprise v1.0.0 →core/gateway/litellm v1.0.0 →core/gateway/traefik-hub v1.0.0 → - $refextiende el esquema (values)
BaseComponents#/schemas/BaseAgentParameter
Usado por
usa el socket «runner»
usa el socket «api»
usa el socket «runner»
usa el socket «api»
usa el socket «services»
usa el socket «api»
usa el socket «services»
usa el socket «services»
usa el socket «sandbox»
usa el socket «plugin_daemon»
usa el socket «ssrf_proxy»
usa el socket «sandbox»
usa el socket «plugin_daemon»
usa el socket «ssrf_proxy»
usa el socket «api»
usa el socket «ssrf_proxy»
usa el socket «api»
usa el socket «api»
usa el socket «sandbox»
usa el socket «plugin_daemon»
usa el socket «ssrf_proxy»
usa el socket «sandbox»
usa el socket «plugin_daemon»
usa el socket «ssrf_proxy»
usa el socket «target_agent»
usa el socket «upstream»
usa el socket «forward_target»
usa el socket «scrape_target»
usa el socket «store»
se aplica a
se aplica a
se aplica a
se aplica a
se aplica a
se aplica a
se aplica a
implementa
implementa