Prerequisites
Everything on this page must be in place before either deployment path (lcf-cli or direct Helm) will succeed.
Required Tools for Deployment
Tool | Minimum version |
|---|---|
Kubernetes |
|
Helm |
|
kubectl |
|
Before installing lcf-cli it is essential that Kubernetes and Helm are installed and operational.
Inferra Image Requirements
This page lists the container images required by the Inferra Helm chart and by lcf-cli deploy probe operations. Use it when preparing registry access, pull secrets, firewall allow lists, or offline image mirroring.
Release Registry
Cloudsmith release publishing mirrors the LCF-owned images below and stamps the release chart with:
LCF-owned images resolve to docker.cloudsmith.io/lightbits/lightbits-inferra/<repository>:<tag>.
Image | Default repository in source chart | Tag source | Used by |
|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| TLS wait init containers, JWT bootstrap job, StepClusterIssuer bootstrap and cleanup jobs, CRD label hook job, Step-CA state restore and sync containers |
|
|
|
|
For non-Cloudsmith source-chart renders, the same repositories render without a registry prefix and default to v1.0.0 unless global.imageRegistry and global.imageTag are set.
Third-Party Chart Images
These images are referenced directly by the chart and are not mirrored by the release workflow. Mirror them into the local registry when the cluster cannot pull from public registries.
Image | Used by | Notes |
|---|---|---|
| Envoy sidecars for | Terminates mTLS or JWT ingress and handles egress routing. |
|
| Can be disabled with |
|
| Rendered when |
| Bundled cert-manager cainjector Deployment | Rendered when |
| Bundled cert-manager controller Deployment | Rendered when |
| Bundled cert-manager webhook Deployment | Rendered when |
| Referenced by cert-manager controller flag | Pulled only if cert-manager creates HTTP-01 ACME solver pods. Inferra workload certificates use Step-CA, not ACME. |
Observability Stack Images
The chart installs an observability stack by default: lcf-observability.enabled is true in charts/lcf/values.yaml, and lcf-cli deploy does not override it. Plan for these images on every install unless the stack is turned off.
The lcf-observability service image itself is LCF-owned and is mirrored by the release workflow; it is listed in the LCF-owned table above. The images below are third party and are not mirrored, so mirror them alongside the other third-party images for a private install.
Image | Used by | Notes |
|---|---|---|
| OpenTelemetry collector container | Receives OTLP metrics and logs from the daemons and from the vLLM connector. |
| VictoriaMetrics container | Metrics storage and query. |
| VictoriaLogs container | Log storage and query. |
| vmalert container | Evaluates the shipped alerting rules. |
| Alertmanager container | Routes alerts. Rendered when |
To install without the stack, pass --set lcf-observability.enabled=false to lcf-cli deploy install, or set it in the values file for a direct Helm install. Doing so removes these five images and the lcf-observability image from the mirror set, and disables the Envoy sidecar for that pod.
lcf-cli Deploy Probe Images
lcf-cli deploy uses temporary probe workloads before or during installation.
Image | Default | Override | Used by |
|---|---|---|---|
| Yes |
| Device inventory DaemonSet |
| Derived from install arguments |
| Registry preflight pull pod that validates image pull access before Helm runs. |
The device probe DaemonSet is temporary. It runs one privileged pod per node, mounts host /sys and /proc read-only, writes the device inventory JSON to pod logs, and is deleted after collection. If --probe-devices=false, lcf-cli deploy skips this image and continues without device-level inventory.
lcf-cli diag collect (Troubleshooting) runs the same image, with the same --probe-image override, in its temporary host DaemonSet, lcf-diag-host-<run id>.
Minimum Image Mirror Set
For a fully private install with bundled cert-manager, bundled step-issuer, bundled Step-CA, and lcf-cli device probing enabled, mirror these images:
Trim the set to match what you actually enable:
If… | Remove from the mirror set |
|---|---|
The cluster already provides cert-manager — set | The four |
Device probing is disabled with |
|
The observability stack is disabled with |
|