Recipe
langfuse
Langfuse as a self-hosted tracing and prompt-registry platform on Kubernetes via the helm provider's Workload synthesis, running the official upstream images directly (no external Helm chart). Renders one Deployment carrying the console and ingestion API and the asynchronous worker, and a ClusterIP Service fronting the console. The configuration contract is authored against Langfuse 4.22.0. The relational backend, the cache and the object store arrive as topology edges; the columnar analytics store is supplied as operator-set pointer strings, and the build halts until both of its addresses are set. infra.external_base_url reaches the console as NEXTAUTH_URL. An attached credential, on a connection or in a Component slot, reaches the containers as an env secretKeyRef, never as a value in the manifest. The encryption key, the session secret, the salt and the object store's secret key have no default: the first three slots are required, and an event_store connection with no credential halts the build unless its values set unauthenticated: true. The backend password, left unattached, renders a development literal; the cache and analytics-store passwords render nothing. A cache publishing valkey-tls or redis-tls is reached over TLS, its certificate checked against the cache connection's server_ca, mounted, or the runtime's trust store; another TLS protocol on the cache halts the build. Reach for this realization where the build must complete with nothing fetched, or where no chart repository is reachable from it; reach for `langfuse-chart`, which renders the platform maintainers' own chart in separate Deployments, where the console and the worker will be scaled independently.
Provenance
- Content digest
- sha256:de0645a17da5d7fc0b0f2df56d105caf949774864c18205799e6098928ecda38
- Published
- 2026-11-10T10:24:50Z
- Signing identity
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signature
- Officialapplication/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:be3b1e23e122c47cd98e82354a75c30ca4d844d495543a86c7153950437ff20e
Reference at this version
oci://hub.aggrega.ai/recipe/helm/langfuse:1.0.0- Target
- —
- Implements
- core/observability/langfuse:1.0.0
Provides
Deterministic pointer templates this recipe wires for consumers.
| Name | Template |
|---|---|
| host | {{ .context.rendered_name }}-default |
| port | {{ .infra.port }} |
| endpoint | http://{{ .context.rendered_name }}-default:{{ .infra.port }} |
| protocol | http |
Workload
Workload · form: stateless · replicas: 1 · containers: main
Locals
| Name | Template |
|---|---|
| console_image | langfuse/langfuse:{{ .infra.engine_version }} |
| worker_image | langfuse/langfuse-worker:{{ .infra.engine_version }} |
Values mapping
No values mapping declared.
Relationships
Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.
Uses
- implementsimplementscontract compatible
core/observability/langfuse:1.0.0
All required outputs are satisfied and every provided output is named in the contract.
Used by
Nothing in the catalog depends on this entity.