cost-onprem-chart

Cost Management On-Premise Helm Repository

This is the Helm chart repository for cost-onprem – a unified Helm chart that deploys Red Hat Cost Management and the Resource Optimization Service (ROS) on OpenShift. The chart packages all required components (Koku, ROS, Kruize, Sources API, PostgreSQL, Valkey, and an Envoy-based API gateway) into a single deployable unit with JWT-based multi-tenant authentication, network policies, and Prometheus monitoring out of the box.

For full documentation, architecture guides, and operational runbooks, see the main repository.

Using This Repository

Add the Helm Repository

helm repo add cost-onprem https://insights-onprem.github.io/cost-onprem-chart
helm repo update

Install the Chart

helm install cost-onprem cost-onprem/cost-onprem \
  --namespace cost-onprem \
  --create-namespace

Install a Specific Version

# List available versions
helm search repo cost-onprem --versions

# Install a specific version
helm install cost-onprem cost-onprem/cost-onprem \
  --namespace cost-onprem \
  --create-namespace \
  --version 0.2.14

OCI Registry (Alternative)

Charts are also published to the GitHub Container Registry:

helm install cost-onprem \
  oci://ghcr.io/insights-onprem/cost-onprem-chart/cost-onprem \
  --namespace cost-onprem \
  --create-namespace \
  --version 0.2.14

Prerequisites

The chart requires OpenShift 4.18+, S3-compatible object storage, and a Kafka cluster. Authentication is handled via Keycloak (RHBK).

Refer to the Installation Guide for detailed prerequisites, and the Resource Requirements Guide for cluster sizing.

Documentation

Category Link
Quick Start Quickstart Guide
Full Installation Installation Guide
Architecture Platform Guide
Configuration Configuration Reference
Authentication Keycloak JWT Setup
TLS TLS Certificate Options
Troubleshooting Troubleshooting Guide
All Documentation Documentation Index

Releases

Each chart version is published as a GitHub Release with auto-generated release notes.

License

See the LICENSE file in the main repository.