Installation

Installing Konflux on Kubernetes clusters - local development, OpenShift, production, OLM, and from source.

This section covers all supported ways to install Konflux. Use the table below to find the right guide for your situation:

My situationGuide
Quick local developmentLocal Deployment (Kind)
Existing OpenShift clusterInstalling on OpenShift
Any Kubernetes cluster, building the operator from sourceBuilding and Installing from Source
Any Kubernetes cluster, release bundleInstalling from Release
Any Kubernetes cluster with OLM installedInstalling from OLM

Before you begin

Make sure the following conditions are met:

  • A Kubernetes cluster is available, or you can create one locally with Kind.
  • The kubectl command-line tool is configured to communicate with your cluster.
  • You have cluster-admin permissions.

Resource sizing

Local development (Kind)Production
Replicas1 per component2–3 per component (HA)
CPU request~30m per component100m+ per component
Memory request~128Mi per component256Mi+ per component
Host RAM8–16 GBBased on load
Host CPU4 cores minimumBased on load

For local deployments, the KIND_MEMORY_GB setting in scripts/deploy-local.env controls how much memory is allocated to the Kind cluster (minimum 8, recommended 16 for a full stack).

For production, replica counts and resource requests can be tuned via the Konflux CR. See the Resource Management guide for details and examples.

Local Deployment (Kind)

Deploying Konflux locally on macOS or Linux using Kind.

Installing on OpenShift

Deploying Konflux on an existing OpenShift cluster using the automated deployment script.

Building and Installing from Source

Building and running the Konflux Operator from source for development or custom deployments.

Installing from Release

Step-by-step guide for installing Konflux from a pre-built release bundle.

Installing from OLM

Installing the Konflux Operator through the Operator Lifecycle Manager (OLM).