Applying the Konflux Custom Resource

How to create a Konflux Custom Resource and verify the installation is ready.

The Konflux Operator deploys all Konflux components from a single Konflux Custom Resource (CR). This page covers how to apply a CR and verify that all components are ready.

Create the Konflux Custom Resource

Apply one of the samples from operator/config/samples/ (or create your own) and wait for Konflux to be ready. See the Examples page for all example configurations.

Do not use konflux_v1alpha1_konflux.yaml for production — it contains demo users with static passwords intended for local testing only. Use OIDC authentication instead.

kubectl apply -f operator/config/samples/<one of the sample files>

Verify the Konflux CR is ready

Wait for the Ready condition if the deployment is still in progress:

kubectl wait --for=condition=Ready=True konflux konflux --timeout=15m

Check the Konflux CR status. When Konflux CR is ready, the output includes the UI URL:

kubectl get konflux konflux
NAME      READY   UI-URL                                                    AGE
konflux   True    https://konflux-ui-konflux-ui.apps.<cluster-domain>       10m