Helm Charts Hub

portefaix-hub is a curated Helm chart registry containing charts optimised for the Portefaix platform. Charts are published as OCI artifacts and are automatically updated via Renovate Bot.

Using the Hub

OCI Registry

# Add the Portefaix Helm repository
helm repo add portefaix-hub https://charts.portefaix.xyz

# Or pull directly as OCI artifact
helm pull oci://ghcr.io/portefaix/portefaix-hub/<chart-name> --version <version>

In FluxCD HelmRelease (deprecated in v2.0.0)

apiVersion: helm.toolkit.fluxcd.io/v2
kind: HelmRelease
metadata:
  name: my-app
  namespace: my-namespace
spec:
  interval: 30m
  chart:
    spec:
      chart: my-app
      version: "1.2.3"
      sourceRef:
        kind: HelmRepository
        name: portefaix-hub
        namespace: flux-system

In ArgoCD Application

spec:
  source:
    repoURL: https://charts.portefaix.xyz
    chart: my-app
    targetRevision: 1.2.3
    helm:
      values: |
        replicaCount: 2

Chart Categories

Chart Development

All Portefaix Hub charts follow these conventions:

• Semantic versioning (MAJOR.MINOR.PATCH)
• Values documented with values.yaml comments and values.schema.json
• Compatibility matrix for Kubernetes versions listed in Chart.yaml
• CI validation with chart-testing on every pull request
• Published to GitHub Container Registry as OCI artifacts

Automated Updates

Renovate Bot monitors upstream chart versions and opens pull requests to update Chart.yaml dependencies automatically. The update pipeline:

1. Renovate detects a new upstream version
2. Opens a PR with the version bumped in Chart.yaml
3. CI runs helm lint and chart-testing
4. Maintainer reviews and merges
5. GitHub Actions packages and publishes the new chart version