Recipe

livekit-server

A LiveKit media server on Kubernetes via the helm provider's Workload synthesis, running the upstream livekit-server image (no external Helm chart). It renders a stateless Deployment plus a ClusterIP Service and declares no volume, because the server keeps room and participant state in memory rather than on disk. It is synthesized because LiveKit's own Helm chart fails the maintained test: the chart its published repository serves packages a server older than the one this Component pins. Media travels over one multiplexed UDP port by default. Setting both range bounds selects a contiguous UDP port range instead, which is emitted as no container or service port and carries client traffic only where the pod uses the node's own network. Binding the state_store edge lets several replicas coordinate through the shared store, over TLS to one publishing valkey-tls or redis-tls, checked against the connection's server_ca, mounted, or the image's trust store. The token-signing secret arrives from the api_secret credential slot by reference, so the plaintext never appears in the rendered manifest. It publishes an in-cluster address only: external-IP discovery is off, and reaching clients outside the cluster is the ingress tier's concern. With `values.metrics_enabled` true the server's metrics are switched on, on port 6789, which joins the container and the ClusterIP Service and checks no caller, and their address is published as provides.metrics_endpoint; false, that key is empty.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:d96dbf092ba1817ccd354f2956aab1b06403a805525ff2cec79d3163e161722d
Published
2026-11-10T10:25:10Z
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:9fb0cd1d6e2fb6ef6b6c8f5ee07594510cfb592fb5a3bd7adcee0f0522162af4

Reference at this version

oci://hub.aggrega.ai/recipe/helm/livekit-server:1.0.0
Target
—
Implements
core/messaging/livekit-server:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .context.rendered_name }}-default
port{{ .infra.port }}
protocolws
api_key{{ .values.api_key }}
metrics_endpoint{{ if .values.metrics_enabled }}http://{{ .context.rendered_name }}-default:6789/metrics{{ end }}

Workload

Workload · replicas: 1 · containers: main

Locals

No locals declared.

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/messaging/livekit-server: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