Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Module Options

Auto-generated reference for all catallaxy module options. Options are split across pages by category to keep each page fast to load.

Lab options

Top-level lab configuration: name, environment, CD strategy, DNS, networking, ingress, registry, and ops commands.

Cluster options

Per-cluster configuration nested under lab.clusters.<name>: Kubernetes settings, provisioners, phases, authentication, and storage.

Component options

Each component declares options under lab.clusters.<name>.components.<name>. Pages are grouped by category:

CategoryComponents
CNICilium
Gateway and DNSGateway, External DNS
PKIcert-manager, trust-manager
ObservabilityPrometheus, Grafana, Loki, Tempo, OTEL Collector
DatabasesCloudNativePG, Redis Operator
FilesystemsOpenEBS, SeaweedFS
SecretsExternal Secrets, SOPS
IdentityKanidm, Kaniop, OIDC
GitOpsArgoCD
Source ControlForgejo
ProvisioningCluster API, Crossplane
OtherVelero, Netbird, Zot, Custom

How options are structured

Every component follows the same pattern:

options.components.<name> = {
  enable = mkEnableOption "<Name>";
  phase = mkOption { default = "<phase>"; };
  namespace = mkOption { default = "<namespace>"; };
  chart = mkOption { ... };
  ref = mkOption { readOnly = true; };
};

The ref attribute provides computed values for cross-component wiring. It is always set, even when the component is disabled, so other components can reference it safely.