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

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
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.

NameTemplate
host{{ .context.rendered_name }}-default
port{{ .infra.port }}
endpointhttp://{{ .context.rendered_name }}-default:{{ .infra.port }}
protocolhttp

Workload

Workload · form: stateless · replicas: 1 · containers: main

Locals

NameTemplate
console_imagelangfuse/langfuse:{{ .infra.engine_version }}
worker_imagelangfuse/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.

Recipe concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy