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
What’s next
- Onboard a new Application — onboard an application, run builds, tests, and releases
- GitHub Application Secrets — create a GitHub App and configure webhook delivery
- Registry Configuration — configure an external container registry for build and release pipelines
- API Reference — full CR field reference
- Troubleshooting — solutions to common installation and runtime issues
- Examples — sample Konflux CR configurations