Skip to content
TrueCharts Charts

The Team

Docs

News

TrueCharts News

Updated OCI Repository Link

Alfred Göppel
Alfred Göppel
Community Development Lead

Move OCI Registry to New Domain and Responds to Bitnami Changes

The OCI repository has been moved from tccr.io to oci.trueforge.org

New Registry Locations

All images and charts previously hosted on tccr.io are now available under the new domain:

  • Images: oci.trueforge.org/tccr/IMAGE
  • Charts: helm install mychart oci://oci.trueforge.org/truecharts/CHART

This change affects only the domain; the registry remains OCI-based as before. Users are encouraged to update their Helm configurations and image references accordingly to avoid interruptions.

Clustertool Updated for Talos 1.11.0

We’re excited to share that we now support Talos 1.11 and Kubernetes 1.34! With the recent update to clustertool, managing and deploying clusters on these versions has never been easier. This ensures smoother operations, up-to-date features, and a more reliable experience for all our users.

Bitnami Policy Shift

Alongside the domain migration, We want to highlight the recent upstream changes from Bitnami. The popular container provider has moved to a “latest-only” publishing model for free users, meaning older tags will no longer be maintained and soon to be removed.

In addition, Bitnami has removed some images entirely, forcing the deprecation of affected TrueCharts applications such as:

  • Solr
  • Matomo

Nextcloud Update 31.0.8

addition, we’ve fixed Nextcloud image creation and released version 31.0.8 for our charts. This update ensures smoother deployments and improved reliability, so you can run Nextcloud with confidence on your clusters.

What Users Should Do:

Update all references from tccr.io to oci.trueforge.org and update their charts and clustertool to the latest version.

Expect Bitnami-based charts to stay stable thanks to digest pinning.

Note that applications relying on deprecated Bitnami images are no longer available via TrueCharts.

We emphasize our commitment to stability and transparency, while continuing to adapt to upstream changes.

Common-2025 finally released

Alfred Göppel
Alfred Göppel
Community Development Lead

TrueCharts Releases common-2025 Helm Library with Major Improvements

The TrueCharts team is proud to announce the release of common-2025, the latest version of the shared Helm chart library powering all TrueCharts charts. This major update delivers powerful new features, improved integrations, and essential structural upgrades that enhance usability, maintainability, and compatibility across the board.

🚀 Key Highlights of common-2025

  • 🔐 Nginx Ingress Integration

    • Disabled by default for a cleaner baseline
    • Built-in support for:
      • Authentication
      • IP whitelisting
      • ThemePark styling

  • 🛠 GitOps CNPG Recovery Enhancements

    • No more need to bump revision numbers during CNPG cluster recovery
    • Using the revision number is now optional.

  • 🌐 Traefik Updates

    • Disabled by default for a cleaner baseline
    • Complete rework of Traefik middlewares, now defined per chart

  • 📦 Resource Management

    • Updated defaults for required pod resources

  • 🔑 Existing Pull Secret Support

    • Added support for using existing Kubernetes secrets for container registry authentication
    • Simplifies integration in environments with pre-configured imagePullSecrets

  • 🧩 Addon System Rework

    • Safe upgrade: prevents updates when some legacy addon layouts are present
    • More configuration options for addons, including:
      • Full access to the workload definition

  • 📁 Structural Cleanups

    • Removal of deprecated Portal (legacy from SCALE)
    • Major improvements to notes.txt
    • Moved MetalLB and Traefik service annotations to centralized integration logic

  • 📊 Autoscaling Enhancements

    • Refactored Horizontal Pod Autoscaler (HPA): To comply to our coding standards and testing regime
    • Added support for Vertical Pod Autoscaler (VPA): Allows for automatically adjusts CPU and memory limits over time

  • 👤 Service Account Overrides

    • Added support to optionally override the service account name in the workload podSpec

  • 🌐 Topology Key Configuration

    • Users can now configure a default topologyKey for scheduling behavior

  • 📌 Pod Affinity Support

    • Added full support for pod affinity, enabling more advanced workload placement strategies
    • Default pod affinity to ensure pods sharing RWO PVCs are started on the same node

🙏 Thank You

This release marks another milestone in the growth of the TrueCharts ecosystem. A huge thank you to all contributors who help build, improve, and maintain all of our charts. Your work makes TrueCharts possible.

And of course, thank you to all users—your feedback, deployments, and support are what drive this project forward every day.

For more information or to get involved, visit: https://truecharts.org

Truenas-Oriented Talos Docker-Compose

Alfred Göppel
Alfred Göppel
Community Development Lead
 Kjeld Schouten
Kjeld Schouten
Ops and R&D Lead

With the release of TrueNAS SCALE Fangtooth, iXsystems has officially switched its virtualization backend from KVM to Incus. This transition has introduced several limitations, and VM support is now also labeled as experimental, leaving users without a stable VM solution on TrueNAS.

Users have reported performance issues with the new Incus-based VM system, and some previously supported configurations such as running VMs with raw-file backed disks (making use of ZFS small-blocks special-vdevs) are no longer functional. Currently, there is no official Incus-Guest-Agent available on Talos, making it difficult for users to control the VM through the TrueNAS UI.

Users have been requesting a Kubernetes solution within the iX-supported Apps/Instances system for quite some time. Traditional containerization approaches like LXC/LXD or jails were never viable options for us as they lack support for Talos and present significant management challenges. However, after careful testing and evaluation, we’ve concluded that integrating Talos in container form within the existing Docker Compose-based Apps system presents a compelling solution. This approach enables users to run Kubernetes on TrueNAS SCALE without the added complexity of virtual machines or the maintenance burden of homegrown setups, striking a practical balance between performance, simplicity and native integration.

In light of this, we have reaffirmed our commitment to the TrueNAS community by releasing a new guide on how to run Talos as a Docker container inside SCALE Apps. This approach provides a practical alternative for those affected by the VM backend changes, allowing continued experimentation and development with Talos despite the Incus limitations.

To get started with Talos as a Docker-Compose App following the following this.

MrPuffins new role

Kjeld Schouten
Kjeld Schouten
Ops and R&D Lead

Hey everyone,

Kjeld here — most of you know me as MrPuffin, or back in the day, Ornias.

Over the past year, we’ve been quietly but steadily working on something big at TrueCharts. Behind the scenes, we’ve focused hard on professionalizing and restructuring the project to make it more sustainable, more scalable, and frankly, more awesome.

Our core energy has been steadily shifting toward building out and refining our Common Chart, improving our CI/CD pipelines, and developing tooling like clustertool — all with the goal of supporting better automation and long-term maintainability. It’s been a gradual but deliberate transition in focus, setting the stage for a more sustainable future for the project.

In the meantime, the charts catalog itself has organically evolved. It’s now primarily driven by community contributions, which is incredible to see. People like Alfi and jagrbombs from our core team are doing fantastic work reviewing and maintaining the quality of incoming PRs. And let’s not forget Stavros, who’s been laser-focused on the Common Chart and pushing forward with unit tests and technical improvements.

But with all this growth comes a shift.

As life changes on my end too, I’ve come to realize I simply can’t do it all — not if we want to keep doing things right. So it’s time for a new phase.

You’ll notice on the team page that I’m officially stepping back from day-to-day involvement with the general chart catalog. That means fewer interactions from me on community chart PRs and general contributions.

Instead, I’ll be focusing 100% of my energy on what matters most for the long-term success of the project:

  • Developing new features for the Common Chart
  • Maintaining and improving our CI/CD and deployment/testing pipelines
  • Coordinating and supporting our amazing volunteer staff

In practice, that means the chart catalog will be almost entirely community-driven — and that’s by design. We’ve built the structure for it, and now it’s time to let it grow.

So, yes, you’ll probably see less of me in Discord and around the edges of the project. But rest assured, I’m still here, still fully committed, just with a more focused role behind the scenes (and on GitHub, of course).

Thanks to everyone who’s helped us get here. This isn’t the end of anything — it’s just the next logical step forward.

Onwards and upwards, Kjeld (MrPuffin)

Clustertool v2

Alfred Göppel
Alfred Göppel
Community Development Lead
 Kjeld Schouten
Kjeld Schouten
Ops and R&D Lead

Just one year ago we were fully dedicated to building TrueNAS SCALE Apps and were forced to move forward to greener pastures. Now, only a year later, we’ve moved to being fully compatible with nearly every Kubernetes platform out there while still offering a staggering amount of Helm Charts.

After long consideration, we’ve decided to stop providing forks/mirrors of complicated charts such as Traefik, Prometheus and so forth. With SCALE gone, we simply don’t need to anymore and users are free to directly consume the upstream charts instead!

This has also allowed us to completely re-evaluate which software we’re using to back the ClusterTool defaults. Hence, ClusterTool V2 is born!

New Clustertool v2 Launches with NGINX Backend and Major Upgrades

The highly anticipated Clustertool v2 is officially released, bringing a host of improvements and a fundamental architectural shift including:

  • a full move to an NGINX backend
  • Designed for improved performance, cleaner configuration, and upstream alignment.

Clustertool v2 is a significant step forward for Kubernetes-based cluster management.

What’s New in Clustertool v2?

The latest version comes with a comprehensive set of changes aimed at making the system more maintainable and future-ready. Key updates include:

  • ✅ Migration to NGINX as the default ingress controller
  • 📦 Inclusion of kube-prometheus-stack for metrics
  • 📦 Upstream integration of many system charts
  • 🧹 Indentation and formatting cleanups across configuration files
  • 📥 Adoption of OCI Mirrors for chart management, boosting speed and reliability

Changes for Existing Clusters

Clusters upgrading to v2 will need to account for several changes:

  • 📦 Repository Adjustments:

    • Updated Repositories list:

      kustomization.yaml
      apiVersion: kustomize.config.k8s.io/v1beta1
      kind: Kustomization
      metadata:
        name: helm-repos
        namespace: flux-system
      resources:
        - bjw-s.yaml
        - cloudnative-pg.yaml
        - home-ops-mirror.yaml
        - jetstack.yaml
        - kustomization.yaml
        - prometheus-community.yaml
        - spegel.yaml
        - truecharts.yaml

    • Added home-operations OCI mirror:

      home-ops-mirror.yaml
      ---
      # yaml-language-server: $schema=https://kubernetes-schemas.pages.dev/source.toolkit.fluxcd.io/helmrepository_v1.json
      apiVersion: source.toolkit.fluxcd.io/v1
      kind: HelmRepository
      metadata:
        name: home-ops-mirror
        namespace: flux-system
      spec:
        type: oci
        interval: 2h
        url: oci://ghcr.io/home-operations/charts-mirror

    • Please compare your Repositories with this template.

    • Charts such as Cilium, Metrics Server, Node-Feature-Discovery, Longhorn, Metallb, and OpenEBS are now pulled via an OCI mirror

  • 🔥 Traefik Removal:
    • Both Traefik and traefik-crds are no longer included and need to be removed
    • Ingress configurations now require annotation updates to work with NGINX
    • ingressClassName is recommended to be set for all ingresses. Additionally, you will need to disable the traefik integration.
  • 🔄 IngressClass Management:
    • New support for using either internal or external ingress classes
    • Clusterenv now includes:
      • NGINX_INTERNAL_IP has been added
      • NGINX_EXTERNAL_IP has been added
      • TRAEFIK_IP has been removed
  • 🧪 Upstream Chart Migrations:
    • Charts such as CloudNativePG, Cert-Manager, and Kube-Prometheus-Stack are now managed upstream
    • 🧭 Check the Quick Start Guide for integration examples

Clustertool as a CI Platform for Chart Testing

With v2, Clustertool is now also being adopted internally as a replacement for the legacy ChartTool, which was previously used to test and release charts but its code was never released publicly.

Special Thanks

Thanks to the home-operations team for providing and maintaining their OCI mirror. 🎉

This ensures every one of us can fully use the power of OCI-backed Helm-charts in our clusters!

Important Notice for SCALE Users

Starting with v2, Clustertool will no longer include any tooling or support for SCALE exports, conversions, or migrations. Users relying on those features should retain v1 or migrate to separate tools.

Ready to update?

Clustertool v2 continues the projects goal of modular, maintainable cluster management and leans into modern best-practices for Kubernetes ecosystem integration. This release sets the foundation for a more streamlined and scalable future.

Ready to upgrade? Check out the full changelog and migration resources to get started.