Community Helm Chart Repository

apps charts hacktoberfest helm k3s k8s k8s-at-home truenas truenas-scale

Go to file

Kjeld Schouten-Lebbing 5b84caa715 fix(apps): correct some ports mistakes (#1416 ) * fix(apps): correct some ports mistakes * Some fixes and cleanup		2021-11-28 10:44:06 +01:00
.chglog	…
.devcontainer	Improve devcontainer UX	2021-09-29 12:33:07 +02:00
.github	docs(readme): update roadmap	2021-11-25 00:12:31 +01:00
.vscode	Improve devcontainer UX	2021-09-29 12:33:07 +02:00
charts	fix(apps): correct some ports mistakes (#1416 )	2021-11-28 10:44:06 +01:00
docs	add official twitch account	2021-11-27 22:18:40 +01:00
templates	chore(metrics): disable metrics GUI by default	2021-11-25 14:34:46 +01:00
tests	fix(tests): adapt tests to prevent future issues with mistakes in the storageClassName generator	2021-11-23 16:25:59 +01:00
tools	feat(prometheus): add some prometheus exporter-Apps (#1388 )	2021-11-23 21:36:27 +01:00
.all-contributorsrc	docs: add timothystewart6 as a contributor for doc (#1397 )	2021-11-24 23:02:06 +01:00
.gitignore	fix the devcontainer	2021-09-28 15:11:33 +02:00
.helmdocsignore	…
.pre-commit-config.yaml	Dont run crlf remover on all PC's	2021-09-10 14:50:28 +02:00
CNAME	…
Gemfile	(tests) move back to ruby based tests (#1051 )	2021-09-28 15:11:36 +02:00
LICENSE	…
NOTICE	…
mkdocs.yml	update the docs a bit	2021-11-19 22:08:52 +01:00

.github/README.md

TrueCharts

Community App Catalog for TrueNAS SCALE

TrueCharts is a catalog of highly optimised TrueNAS SCALE Apps. Made for the community, By the community!

Our primary goals are:

Micro-Service Centered
Native Kubernetes
Stability
Consistency

All our apps are supposed to work together, be easy to setup using the TrueNAS UI and, above all, give the average user more than enough options to tune things to their liking.

Getting started using TrueCharts

Installing TrueCharts within TrueNAS SCALE, is possible using the TrueNAS SCALE Catalog list.

For more information: https://truecharts.org/manual/Quick-Start%20Guides/01-Adding-TrueCharts/

Support

Please check our FAQ, manual and Issue tracker There is a significant chance your issue has been reported before!

Still something not working as expected? Contact us! and we'll figure it out together!

Roadmap

For big changes we do have a roadmap, every spot on the roadmap is synced to a TrueNAS SCALE Release and should be read as "Should be added at or before this release"

MariaDB and External-DNS - TrueNAS SCALE "Angelfish" RC2

There are many community requested containers that cannot be run using just a postgresql servers, we'll aim to streamline support for a few more dependencies and some improved support for External-DNS on-top

Documentation - TrueNAS SCALE "Angelfish" RELEASE

While preparing for the formal release of TrueNAS SCALE, we still have some things to polish

Multi-Pod support for Common - TrueNAS SCALE "Bluefin" 22.xx ALPHA 1

Our current common library is not fully supporting with multi-pod containers, while we cannot add everything we should support some basic multi-pod containers on common.

Finish Prometheus Support - TrueNAS SCALE "Bluefin" 22.xx ALPHA 2

By this date it would be about a year after we first started considering adding Prometheus support, it's time to add metrics exporters to as many apps as we can.

Mail server - TrueNAS SCALE "Bluefin" 22.xx BETA 1

Great mail-server deployments require support for multi-pod containers, high availability and a solid backend. By this date, all those boxes should start to become checked and we should check the "mail server" box as well

Development

Our development process is fully distributed and agile, so every chart-maintainer is free to set their own roadmap and development speed and does not have to comply to a centralised roadmap. This ensures freedom and flexibility for everyone involved and makes sure you, the end user, always has the latest and greatest of every App installed.

Getting into creating Apps

Creating charts takes some getting used to, as it's based on Helm charts. We highly suggest prior know-how on creation/modifying Helm Charts, before taking on the challenge of creating SCALE Apps.

For more information on creating SCALE Apps and Helm charts, please check out our development manual

Automation and you

We provide a lot of tools to make it easier to develop charts, templates, automated testing, automated fixes, automated docs. Even automated update is included. We also actively try to collaborate with other k8s community projects on tooling, for the betterment of all!

Those tools do, however, take time to develop and are certainly not bug free. If you find mistakes in our tooling, please feel free to repost issues or submit any fixes you feel appropriate!

Contact and Support

To contact the TrueCharts project:

Create an issue on Github issues
Open a discussion on GitHub Discussions
Send us an email
Or join our Discord server

Featured Projects

A lot of our work is based on the great effort of others. We would love to extend special thanks to these projects we owe a lot to:


TrueNAS SCALE	K8S-At-Home	Traefik	Authelia

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_{Kjeld Schouten-Lebbing} 💻 🚇 📖	_{Justin Clift} 📖	_whiskerz007 💻	_{Stavros Kois} 💻 📖	_allen-4 💻	_{Troy Prelog} 💻 📖	_{Dan Sheridan} 💻
_{Sebastien Dupont} 📖	_Vegetto 👀	_{Luuk Nieuwdorp} 💻	_{Nate Walck} 💻	_Lloyd 💻	_{Dave Withnall} 📖	_ksimm1 📖
_{Aaron Johnson} 📖	_Ralph 💻	_{Joachim Baten} 💻	_{Michael Yang} 💻	_{Ciaran Farley} 📖	_{Heavybullets8} 📖	₆₆₂ 💻
_alex171 📖	_{Techno Tim} 📖

This project follows the all-contributors specification. Contributions of any kind welcome!

Licence

Truecharts as a whole, is based on a BSD-3-clause license, this ensures almost everyone can use and modify our charts. However: As a lot of Apps are based on upstream Helm Charts, Licences can vary on a per-App basis. This can easily be seen by the presence of a "LICENSE" file in the App root folder.

Some Apps may also contain parts in other licenses, such as libraries or templates, these files can be recognised by their individual headers.

SPDX-License-Identifier: BSD-3-Clause