Skip to main content

· 2 min read
Kjeld Schouten-Lebbing

From the early stages of TrueNAS SCALE development, we’ve read many complaints about the fact docker-compose wasn’t supported by TrueNAS SCALE. It’s understandable, as it’s one of the most used docker deployment options for home users.

The TrueNAS SCALE community has figured out interesting ways to enable Docker-Compose. But this approaches all have a number of downsides:

  • It's not future proof, it can be nuked permanently and without warning, with any TrueNAS SCALE update.

  • It inherently breaks SCALE Applications and often even requires those to be disabled.

  • There is no support for this work-around.

To solve this problem, we’ve decided to take matters into our own hands. We are glad to finally announce our solution:

Docker-Compose Application for TrueNAS SCALE by TrueCharts

It’s designed from the ground up, to give users nearly the same experience as running Docker-Compose on the host system, and even contains some nice tweaks:

  • It’s fully backed by TrueNAS SCALE Applications, so it will survive updates.

  • There is a GUI option to input your Docker-Compose file, that will survive reboots.

  • Completely self-contained, and will not modify the default docker stack.

  • Fully compatible to run alongside other TrueNAS SCALE Applications, so you can easily migrate your Docker-Compose applications to TrueNAS SCALE Applications.

  • We are your support if the application does not work as advertised.

All with just one caveat:

  • The Docker-Compose command has to be executed from inside the container shell.

We based our solution on the official Docker-in-Docker container by Docker, with some added tooling to optimize it for single-container deployments. Perhaps most interestingly, the container has native access to /mnt, /root and /cluster, so you can work with your containers like you’re working on the host.

With this in place we hope that TrueNAS SCALE can finally start to fill the big shoes of solutions like Unraid and TrueNAS Core and give the community what they want, not just what they need!

· 3 min read
Kjeld Schouten-Lebbing

Enterprise storage does not need to be rigid and difficult. TrueNAS SCALE is scale-out storage and hyperconverged infrastructure that is also flexible. Key to that flexibility is the inclusion of Kubernetes for deploying containerized (e.g. docker) applications. Kubernetes allows single containers or pods of containers to be easily deployed on a unified infrastructure. A growing assortment of these applications are now preconfigured for easy deployment using a TrueNAS-enhanced implementation of Helm Charts.

Users and third parties can now build catalogs of application charts for deployment with the ease of an app store experience. These catalogs are like app stores for TrueNAS SCALE. iXsystems has been collaborating and sponsoring the team developing TrueCharts, the first and most comprehensive of these app stores. Best of all, the TrueCharts Apps are free and Open Source. TrueCharts offers a diverse set of easily-deployed applications for TrueNAS users, with more than 180 available apps to choose from. We’ve invited the TrueCharts team to write a guest blog to share the details.


With streamlined Kubernetes support for its ”apps”, TrueNAS SCALE has made the big step of bringing Kubernetes to the masses while staying true to its Open Source philosophy by empowering the community to build their own apps and catalogs. This ability for users to pick their own favorite catalogs for apps has already proven to be popular. Meet TrueCharts, the first community apps catalog!

TrueCharts was built by the founders of a group who developed installation scripts for TrueNAS CORE, called “Jailman”. TrueCharts offers more than what Jailman was capable of: a flexible, user-friendly installer with a freedom of choice that users need and deserve!

Working as a completely independent project, the TrueCharts community has since invested an entire year carefully crafting tools that provide many of the awesome features that Kubernetes has to offer to the TrueNAS SCALE apps ecosystem. For example, all apps can be simply enabled with Traefik reverse proxy and Wireguard VPN capabilities. In addition to the official apps like Plex, Nextcloud, and Minio, TrueCharts adds a huge variety of apps including Vaultwarden, Handbrake, OpenLDAP, Photoprism, Pihole, Syncthing, and more.

TrueCharts was designed with one primary goal in mind: to serve as a solid framework for users who are new to Kubernetes while also exposing as many Kubernetes features as possible for experienced users. Where the official apps by iXsystems focus on easy deployment, TrueCharts focuses on those applications that need a bit more flexibility to customize the app for specific use cases and system environments. TrueCharts is managed from within the TrueNAS SCALE UI. Simply add the catalog and follow the Quick Start guides!

As the release of TrueNAS SCALE 22.02 “AngelFish” is getting closer and closer, the TrueCharts Team and iXsystems are already hard at work looking into a future of apps with high availability, dynamic scaling, and distributed storage. Want to know more about TrueCharts? Visit or come visit our great community: TrueCharts on Discord!

TrueCharts and TrueNAS = Endless Possibilities

· 2 min read
Kjeld Schouten-Lebbing

The last year we’ve grown at an ever-increasing pace, doubling code and users every few months. Some issues could be fixed quickly and easily, while other issues were vastly more complex. One of those issues happened to be the convoluted mess of different container sources.

These container sources all had different tag formats, rate limits, downtimes, and one even decided to start deleting tags, leading to applications breaking. This, obviously, was not the experience we wanted our users to have.

Therefore, we’ve spent the better part of December setting up our own container distribution system. The TrueCharts Container Repository, or TCCR in short. TCCR is a combination of containers we’ve fully built ourselves and containers we mirror, screen and re-tag into a standardized format. Doing this also allowed us to ensure all containers are available from multiple sources: GHCR, Quay and Dockerhub.

To achieve this, we’ve partnered with, which allows us to easily switch between container sources for our repository, while also giving us something new: metrics. We can finally see which containers are popular and which are not, but we can also see if there are people still using older versions of applications. This allows us to improve our decision-making process: which apps to work on and which older versions to keep supporting.

All of you have (under the hood), already been running TCCR and we’ve only had a handful of issues related to it. We’re happy to have created something that again, highlights us as the number 1 source for TrueNAS SCALE Applications.