Skip to content

TrueCharts News

Refreshed Train Names, Team Changes and DragonFish Support

We’re back with some thrilling announcements that promise to enhance your experience with our platform. From revamped train names to key team appointments and even experimental support for TrueNAS SCALE 24.04 DragonFish, there’s a lot to unpack. Let’s dive right in!

Train Name Refresh: Introducing Premium and System Trains

First off, we’re thrilled to introduce our revamped train names: Premium Train and System Train. Say goodbye to the old names; these new labels better align with the quality and breadth of resources you’ll find within. You’ll find both an automated script and a one-by-one version to deal with this name change for you, for both SCALE and Helm platforms, at the bottom of this article.

Enterprise out, Premium in

This change reflects the fact that this train no longer specifically targets enterprise customers, but in general stands for higher-quality charts.

Hello, Operator? No, this is System

This name change reflects this train no longer just containing operators, but now also includes additional important system charts.

Meet Our New Team Appointments

  1. @bitpushr Assumes Role of Docs Maintainer: Join us in welcoming @bitpushr as our new Docs Maintainer, succeeding @JagrBombs (Steven). With their expertise and dedication, we’re confident our documentation will remain top-notch.

  2. @kofeh Takes Charge as Support Coordinator: Say hello to @kofeh, our new Support Coordinator, succeeding @Xstar97TheNoob. With his stellar communication skills, he’s ready to ensure you receive the assistance you need.

  3. @Xstar97TheNoob Transitions to Stable Train Maintainer: We’re proud to announce that @Xstar97TheNoob is now our Stable Train Maintainer, ensuring the stability and reliability of our platform.

Experimental Support for TrueNAS SCALE 24.04 DragonFish

In a bold move, we’ve added initial prototype support for TrueNAS SCALE 24.04 DragonFish. However, it’s crucial to note that this support is still highly experimental. As such, we do not offer staff support or guarantee data integrity for the BETA or TC versions of TrueNAS SCALE 24.04 DragonFish. You can read more on the steps required for running TrueNAS SCALE 24.04 Dragonfish [here](/.

Our Successful Bounty Program

We’re thrilled to share that our new bounty program has been incredibly successful! This initiative allows contributors to earn rewards for their valuable contributions to our project. If you’d like to learn more or get involved, check out our bounty program on Open Collective: TrueCharts Bounties.

A Note on Donations

While our bounty program has seen fantastic results, it’s important to note that bounties do not replace donations. Our project relies on the continued support of our loyal donors to thrive. If you’d like to contribute to our cause, consider making a donation via our Open Collective page: Donate to TrueCharts.

Conclusion

With these updates and additions, we’re committed to providing you with an unparalleled experience on our platform. As always, your feedback is invaluable to us. Reach out with any questions or suggestions, and stay tuned for more exciting developments!

Thank you for being part of the TrueCharts community.

Note: Automated Migration Script for train name changes

To ensure a seamless transition to the new train names, we’ve developed a script that automates the process across all relevant namespaces. Here’s the code! Please be aware we do not give guarantees and this script may need adapting to your environment and/or additional permissions.

Helm Platform - Automated Migration Script

save as nameupdate.sh and run chmod +x nameupdate.sh before running it

#!/bin/bash
# Loop through all namespaces prefixed by "ix-"
for ns in $(kubectl get namespaces -o jsonpath='{.items[*].metadata.name}' | grep '^ix-'); do
# Check if the namespace has "catalog_train" label set to "enterprise" or "operators"
catalog_train_label=$(kubectl get namespace "$ns" -o jsonpath='{.metadata.labels.catalog_train}')
if [[ "$catalog_train_label" == "enterprise" ]]; then
# Patch the namespace to change the "catalog_train" label to "premium"
kubectl patch namespace "$ns" -p '{"metadata":{"labels":{"catalog_train":"premium"}}}'
echo "Namespace $ns updated from enterprise to premium."
elif [[ "$catalog_train_label" == "operators" ]]; then
# Patch the namespace to change the "catalog_train" label to "system"
kubectl patch namespace "$ns" -p '{"metadata":{"labels":{"catalog_train":"system"}}}'
echo "Namespace $ns updated from operators to system."
fi
done

SCALE Platform - Automated Bash Shell Migration Script

simply copy-paste this into the shell of your TrueNAS SCALE GUI

Terminal window
curl -sSL https://raw.githubusercontent.com/xstar97/scale-scripts/main/scripts/patchTCTrains.sh | bash --

SCALE Platform - Automated Migration Script

save as nameupdate.sh and run chmod +x nameupdate.sh before running it

#!/bin/bash
# Loop through all namespaces prefixed by "ix-"
for ns in $(k3s kubectl get ns --no-headers | grep "^ix-" | awk '{print $1}' ORS=' '); do
# Check if the namespace has "catalog_train" label set to "enterprise" or "operators"
catalog_train_label=$(k3s kubectl get namespace "$ns" -o jsonpath='{.metadata.labels.catalog_train}')
if [[ "$catalog_train_label" == "enterprise" ]]; then
# Patch the namespace to change the "catalog_train" label to "premium"
k3s kubectl patch namespace "$ns" -p '{"metadata":{"labels":{"catalog_train":"premium"}}}'
echo "Namespace $ns updated from enterprise to premium."
elif [[ "$catalog_train_label" == "operators" ]]; then
# Patch the namespace to change the "catalog_train" label to "system"
k3s kubectl patch namespace "$ns" -p '{"metadata":{"labels":{"catalog_train":"system"}}}'
echo "Namespace $ns updated from operators to system."
fi
done

Manual Migration Script

Use this script to manually migrate your existing SCALE apps to the new trains. Replace blocky with the app name in question and premium with the new train-name.

Terminal window
k3s kubectl patch ns ix-blocky -p '{"metadata":{"labels":{"catalog_train":"premium"}}}'

🎉 Introducing: TrueCharts Bounties! 🎉

We’re thrilled to announce a significant update that we believe will make contributing to TrueCharts even more rewarding and engaging for all of you.

Introducing TrueCharts Bounties! We’re revolutionizing the way you can support TrueCharts development and be directly involved in shaping its future.

While our traditional chart-order system served us well, we’ve listened to your feedback and are now transitioning to a dynamic and transparent bounty system. With TrueCharts Bounties, you now have the opportunity to directly influence the development of our charts and contribute to our collective mission in a more impactful way.

What does this mean for you?

🔍 Greater Flexibility: You can now place bounties on GitHub issues or submit chart requests, both of which will be seamlessly integrated into our development pipeline.

💰 Earn Rewards: By placing bounties, you not only support the development of the charts you care about but also have the chance to earn rewards for your contributions.

🛠️ Empowered Collaboration: TrueCharts Bounties foster a collaborative environment where community members can actively participate in shaping the future of TrueCharts.

We want to emphasize the vital role of donations in sustaining TrueCharts. 💖 Your generous support is the lifeblood that keeps our project thriving and enables us to continue providing valuable resources to the community. 💪

To get started with TrueCharts Bounties, visit: TrueCharts Bounties

To make a donation, please visit: Donate to TrueCharts

Whether you’re a seasoned developer, a passionate user, or someone with a great idea, we welcome you to join us in this new chapter of TrueCharts development.

Thank you for your continued support and dedication. Together, we’ll continue to make TrueCharts the best it can be.

Happy charting!

The TrueCharts Team

Embrace KubeApps, Rancher, and FluxCD! 🚀

Exciting news! TrueCharts is taking a leap forward by officially adding support for KubeApps, Rancher, and FluxCD to our deployment options. This expansion complements our existing support for Normal “Native” Helm Charts and TrueNAS SCALE Apps, offering you a broader range of choices for seamless application deployment.

A Quick Recap of the Tiers

Tier 1: Normal “Native” Helm Charts Our versatile foundation! While not the origin, this tier serves as the baseline for Helm Chart functionality. All features work smoothly, and our team, particularly the developers, are well-versed in Helm.

Tier 2: Welcoming KubeApps and FluxCD In this tier, we introduce KubeApps, Rancher, and FluxCD – like the cool cousins of Helm Charts. They come with optional GUI elements, and we’re currently configuring KubeApps and Rancher via YAML through the web GUI, with plans for UI enhancements in 2024.

Tier 3: TrueNAS SCALE Apps and Rancher The third tier introduces TrueNAS SCALE Apps, where a bit more abstraction comes into play. While we strive for the best, 100% stability isn’t guaranteed due to the added layers. Expect some limitations, like fewer features, no direct YAML edits, and a few more bugs.

Not Supported (yet): ArgoCD Currently we’ve one planned future addition: ArgoCD. But due to technical issues from ArgoCD, we cannot yet support it and it will not work reliably yet with TrueCharts Helm Charts either.

Behind the Expansion

This expansion is about offering you more choices while maintaining the excellence you expect from TrueCharts. It’s about enriching your deployment experience with flexibility and reliability.

There is more

But there is more, in addition to supporting KubeApps on Normal Kubernetes, we’ve also released KubeApps as a TrueNAS App. Allowing you to install everything in both Bitnami and TrueCharts Repositories, straight onto your TrueNAS Kubernetes system, using KubeApps!

What’s on the Horizon?

The journey doesn’t stop here! Throughout 2024, we’re delving deeper into KubeApps, Rancher, and FluxCD. Additionally, we’re committed to providing more comprehensive documentation for every Helm Chart and supported platform. Stay tuned for more updates as we continue growing together. 🌐✨

Small SCALE Changes

There have been some minor changes to how some things are done on SCALE. None of them will require a reinstall and the migration steps are not going to cause any likely breakage.

Nextcloud

Nextcloud has moved to the enterprise train. To migrate from stable to enterprise train versions, run the following command in SCALE terminal: k3s kubectl patch ns ix-nextcloud -p '{"metadata":{"labels":{"catalog_train":"enterprise"}}}'

If not using the root user, please prefix this with sudo

GPUs

We’ve decided to remove the SCALE-specific way of handling GPU loading, in favor of the “normal” way it’s done in kubernetes. One of the reasons why we’ve decided to do this, is the fact that the language used by iX-Systems is very confusing for the user and adding their custom middleware on-top of normal kubernetes makes it less reliable.

In short, this means you will have to specify the number of GPU’s to assign to an App under Resources and Devices and then the Resource Limits section, with your specific GPU type (either AMD, NVIDIA or Intel) as below:

GPU

From an end-user perspective, the option has just moved to a slightly different place and instead of a drop-down you’ll have to enter a number of GPU’s to assign, 1 in most cases.

Pre-DragonFish Storage

To make it easier to migrate to DragonFish, all users are advised to set any-and-all references to “StorageClass” to SCALE-ZFS for any existing charts/apps. This option is found under the Storage and Persistence section as below:

SCALE-ZFS

This ensures those charts/apps stay working after migrating to TrueNAS SCALE DragonFish in the future.

If you do not do this, we cannot guarantee your data stays in tact when you move to DragonFish in the future.

Technical Common Changes

These changes do not affect end-users of the charts/apps, but are breaking changes in the common library if used directly by DIY/experienced users building their own helm charts.

Removal of SCALE certificates support

After removing SCALE Certificates support from our GUI setup, we’ve now also removed it from the common library chart.

Removal of iXVolumes

iXVolumes was the weird storage solution designed by iX-Systems that created hostPath mounted datasets, automatically. A bit like PVC, but without complying to any industry standards.

We’ve never been using it, nor ever supported it in our charts. Hence we’ve decided to remove it from the common library chart as well.

Removal of SCALE GPU

Besides the removal of SCALE GPU GUI from the end-user GUI, it’s also completely scrubbed from the common library-chart as it is completely replaced.

Exciting Licensing Changes

We’ve made some important updates regarding the licensing of our Chart Repository and associated Helm-charts. After careful consideration, we have made decisions that we believe will better align with the needs of our OpenSource user base and contribute to the continued growth of the TrueCharts ecosystem.

Transition to AGPL Licensing

One of the primary changes involves transitioning the licensing of the majority of our Chart Repository from BSD-3 to AGPL. This shift reflects our commitment to fostering open collaboration and ensuring that derivative works are also open-source. We believe that this move will contribute to a more vibrant and participatory community around TrueCharts.

Open-Sourcing Charts Under AGPL

In addition to the change in repository licensing, we are excited to announce that many of the charts, previously licensed under the Business-Software-License, are now open-sourced under AGPL as well. This decision is in line with our dedication to open-source principles and providing the community with greater access and freedom.

Commercial Licensing Options

Recognizing the diverse needs of our users, especially our commercial friends, we are introducing a commercial licensing option. This AGPL-less license is designed for use in or with a single cluster. This commercial license comes with a Service Level Agreement (SLA) that includes guaranteed response times, ensuring a reliable and responsive experience for our valued commercial users.

How to Explore Commercial Licensing

If you are interested in exploring our commercial licensing option, please reach out to us at [email protected]. Our team will be happy to discuss your specific requirements and work with you to find a solution that fits your needs.

We believe that these changes will contribute to the continued success and sustainability of TrueCharts. As we evolve, we are more-than-ever committed to open communication and transparency. We value the continued support greatly and look forward to a future of collaboration and innovation within the TrueCharts community.

Thank you all for being part of the TrueCharts journey!