Install Konstruct

Install Konstruct on any Kubernetes cluster to start managing your platform infrastructure.

Summary

Konstruct 0.3 introduces a minimal installation model. Install Konstruct on any Kubernetes cluster with no pre-existing infrastructure required beyond the cluster itself.

Prerequisites

• Kubernetes cluster (v1.24+)
• Helm 3.x installed
• kubectl configured to access your cluster

Install

Install Konstruct with no external dependencies:

helm install konstruct oci://europe-west2-docker.pkg.dev/civo-com/charts/konstruct \
  --version 0.3.1 \
  --namespace konstruct-system \
  --create-namespace \
  --set konstruct-api.extraEnv.DISABLE_AUTH=true \
  --set konstruct-api.vaultSecretPath="" \
  --set konstruct-api.externalSecrets.apiSecrets.enabled=false \
  --set konstruct-api.externalSecrets.dexConfig.enabled=false \
  --set konstruct-api.ingress.enabled=false \
  --set konstruct-ui.ingress.enabled=false

What this does:

• DISABLE_AUTH=true - Bypasses OIDC authentication (auto-login as admin)
• vaultSecretPath="" - Skips ExternalSecret CRD (no external-secrets-operator required)
• ingress.enabled=false - No ingress controller required (use port-forward)

tip

This install is ideal for development, testing, or environments where you'll configure SSO and ingress separately later.

Access the UI

Port-forward to access the Konstruct UI:

kubectl port-forward svc/konstruct-konstruct-ui -n konstruct-system 8080:8080

Open http://localhost:8080 in your browser.

Verify Installation

Check that all pods are running:

kubectl get pods -n konstruct-system

All pods should reach Running status.

Cluster Requirements

Minimum Resources

Resource	Minimum	Recommended
Nodes	2	3+
CPU per node	4 cores	8 cores
Memory per node	8 GB	16 GB
Storage	50 GB	100 GB

Supported Kubernetes Distributions

• Amazon EKS
• Google GKE
• Azure AKS
• Civo Kubernetes
• k3s / k3d
• kind (development only)
• Any CNCF-conformant Kubernetes 1.24+

Upgrading

From 0.2 to 0.3

If upgrading from Konstruct 0.2, see the 0.3 Release Notes for the migration sequence.

From 0.3.x to 0.3.y

Standard Helm upgrade:

helm upgrade konstruct oci://europe-west2-docker.pkg.dev/civo-com/charts/konstruct \
  --version 0.3.1 \
  --namespace konstruct-system \
  --reuse-values

Uninstalling

helm uninstall konstruct --namespace konstruct-system
kubectl delete namespace konstruct-system

warning

Uninstalling Konstruct removes the operators but preserves CRDs and Custom Resources by default. To fully remove all resources, delete the CRDs manually.

Supported Installs

The Konstruct engineering team provides guided installation for production deployments. To receive a demo or arrange a supported installation, schedule time with us.

Supported installations include:

• Architecture review and sizing recommendations
• Custom cluster template configuration
• SSO and identity provider integration
• Multi-cloud setup assistance

What's Next?

After installation:

1. Access the Konstruct UI
2. Create your organization
3. Configure cloud accounts
4. Create your first cluster

Getting Support

• Documentation
• Create a Support Ticket