2021-04-11 09:31:23 -04:00
# TrueCharts<br>
2021-02-25 11:09:50 -05:00
**Community App Catalog for TrueNAS SCALE**
2020-12-30 15:38:12 -05:00
2021-03-31 16:50:04 -04:00
[![docs ](https://img.shields.io/badge/docs-rtfm-yellow?logo=gitbook&logoColor=white&style=for-the-badge )](https://truecharts.org/)
2021-04-11 08:23:17 -04:00
[![Discord ](https://img.shields.io/badge/discord-chat-7289DA.svg?maxAge=60&style=for-the-badge )](https://discord.gg/tVsPTHWTtr)
2021-03-31 16:50:04 -04:00
[![GitHub last commit ](https://img.shields.io/github/last-commit/truecharts/apps?color=brightgreen&logoColor=white&style=for-the-badge )](https://github.com/truecharts/apps/commits)
2021-04-11 08:40:33 -04:00
2021-02-25 11:09:50 -05:00
---
2021-04-11 09:10:51 -04:00
TrueCharts is a catalog of highly optimised TrueNAS SCALE Apps. Made for the community, By the community!
2020-12-30 15:38:12 -05:00
Our primary goals are:
2021-03-31 16:50:04 -04:00
- Micro-Service Centered
- Native Kubernetes
2020-12-30 15:38:12 -05:00
- Stability
2021-08-14 15:41:27 -04:00
- Consistency
2020-12-30 15:38:12 -05:00
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.
2021-04-11 09:02:04 -04:00
< br >
2020-12-30 15:38:12 -05:00
## Getting started using TrueCharts
2021-04-11 09:02:04 -04:00
[![docs ](https://img.shields.io/badge/docs-rtfm-yellow?logo=gitbook&logoColor=white&style=for-the-badge )](https://truecharts.org/)
2021-08-08 08:46:54 -04:00
2021-04-11 09:02:04 -04:00
---
2021-03-31 16:50:04 -04:00
Installing TrueCharts within TrueNAS SCALE, is possible using the TrueNAS SCALE Catalog list.
2020-12-30 15:38:12 -05:00
2021-03-31 16:50:04 -04:00
For more information:
2021-08-17 11:32:18 -04:00
https://truecharts.org/manual/Quick-Start%20Guides/02-Adding-TrueCharts/
2021-02-22 10:07:09 -05:00
2021-04-11 08:36:39 -04:00
### Support
2021-05-02 05:44:41 -04:00
Please check our [FAQ ](https://truecharts.org/about/ ), [manual ](https://truecharts.org/manual/SUPPORT/ ) and [Issue tracker ](https://github.com/truecharts/apps/issues ) There is a significant chance your issue has been reported before!
2021-04-11 08:36:39 -04:00
Still something not working as expected? [Contact us! ](https://truecharts.org/about/contact/ ) and we'll figure it out together!
2021-04-11 08:47:12 -04:00
### Roadmap
2021-04-11 08:36:39 -04:00
2021-08-30 10:33:12 -04:00
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 before this release"
2021-02-17 06:38:14 -05:00
2021-04-11 08:36:39 -04:00
2021-08-30 10:33:12 -04:00
< br >
2021-04-11 09:02:04 -04:00
2021-08-30 10:33:12 -04:00
**Documentation and DNS - TrueNAS SCALE 21.10**
2021-04-11 08:36:39 -04:00
2021-08-30 10:33:12 -04:00
_We aim to improve our quick-start guides the comming few months and at the same time dail with DNS related Apps such as ExternalDNS_
2021-04-11 08:36:39 -04:00
2021-05-10 08:33:13 -04:00
< br >
2021-08-30 10:33:12 -04:00
**Email and VPN - TrueNAS SCALE 21.12**
2021-05-10 08:33:13 -04:00
2021-08-30 10:33:12 -04:00
_Our goal these months will be enabling users to run an Email server on their SCALE machine and allow using our software with VPN sidecards_
2021-04-11 08:36:39 -04:00
2021-04-11 09:02:04 -04:00
< br >
2021-04-11 08:47:12 -04:00
2021-04-11 09:02:04 -04:00
## Development
2021-04-11 08:47:12 -04:00
[![pre-commit ](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white&style=for-the-badge )](https://github.com/pre-commit/pre-commit)
[![renovate ](https://img.shields.io/badge/renovate-enabled-brightgreen?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjUgNSAzNzAgMzcwIj48Y2lyY2xlIGN4PSIxODkiIGN5PSIxOTAiIHI9IjE4NCIgZmlsbD0iI2ZlMiIvPjxwYXRoIGZpbGw9IiM4YmIiIGQ9Ik0yNTEgMjU2bC0zOC0zOGExNyAxNyAwIDAxMC0yNGw1Ni01NmMyLTIgMi02IDAtN2wtMjAtMjFhNSA1IDAgMDAtNyAwbC0xMyAxMi05LTggMTMtMTNhMTcgMTcgMCAwMTI0IDBsMjEgMjFjNyA3IDcgMTcgMCAyNGwtNTYgNTdhNSA1IDAgMDAwIDdsMzggMzh6Ii8+PHBhdGggZmlsbD0iI2Q1MSIgZD0iTTMwMCAyODhsLTggOGMtNCA0LTExIDQtMTYgMGwtNDYtNDZjLTUtNS01LTEyIDAtMTZsOC04YzQtNCAxMS00IDE1IDBsNDcgNDdjNCA0IDQgMTEgMCAxNXoiLz48cGF0aCBmaWxsPSIjYjMwIiBkPSJNMjg1IDI1OGw3IDdjNCA0IDQgMTEgMCAxNWwtOCA4Yy00IDQtMTEgNC0xNiAwbC02LTdjNCA1IDExIDUgMTUgMGw4LTdjNC01IDQtMTIgMC0xNnoiLz48cGF0aCBmaWxsPSIjYTMwIiBkPSJNMjkxIDI2NGw4IDhjNCA0IDQgMTEgMCAxNmwtOCA3Yy00IDUtMTEgNS0xNSAwbC05LThjNSA1IDEyIDUgMTYgMGw4LThjNC00IDQtMTEgMC0xNXoiLz48cGF0aCBmaWxsPSIjZTYyIiBkPSJNMjYwIDIzM2wtNC00Yy02LTYtMTctNi0yMyAwLTcgNy03IDE3IDAgMjRsNCA0Yy00LTUtNC0xMSAwLTE2bDgtOGM0LTQgMTEtNCAxNSAweiIvPjxwYXRoIGZpbGw9IiNiNDAiIGQ9Ik0yODQgMzA0Yy00IDAtOC0xLTExLTRsLTQ3LTQ3Yy02LTYtNi0xNiAwLTIybDgtOGM2LTYgMTYtNiAyMiAwbDQ3IDQ2YzYgNyA2IDE3IDAgMjNsLTggOGMtMyAzLTcgNC0xMSA0em0tMzktNzZjLTEgMC0zIDAtNCAybC04IDdjLTIgMy0yIDcgMCA5bDQ3IDQ3YTYgNiAwIDAwOSAwbDctOGMzLTIgMy02IDAtOWwtNDYtNDZjLTItMi0zLTItNS0yeiIvPjxwYXRoIGZpbGw9IiMxY2MiIGQ9Ik0xNTIgMTEzbDE4LTE4IDE4IDE4LTE4IDE4em0xLTM1bDE4LTE4IDE4IDE4LTE4IDE4em0tOTAgODlsMTgtMTggMTggMTgtMTggMTh6bTM1LTM2bDE4LTE4IDE4IDE4LTE4IDE4eiIvPjxwYXRoIGZpbGw9IiMxZGQiIGQ9Ik0xMzQgMTMxbDE4LTE4IDE4IDE4LTE4IDE4em0tMzUgMzZsMTgtMTggMTggMTgtMTggMTh6Ii8+PHBhdGggZmlsbD0iIzJiYiIgZD0iTTExNiAxNDlsMTgtMTggMTggMTgtMTggMTh6bTU0LTU0bDE4LTE4IDE4IDE4LTE4IDE4em0tODkgOTBsMTgtMTggMTggMTgtMTggMTh6bTEzOS04NWwyMyAyM2M0IDQgNCAxMSAwIDE2TDE0MiAyNDBjLTQgNC0xMSA0LTE1IDBsLTI0LTI0Yy00LTQtNC0xMSAwLTE1bDEwMS0xMDFjNS01IDEyLTUgMTYgMHoiLz48cGF0aCBmaWxsPSIjM2VlIiBkPSJNMTM0IDk1bDE4LTE4IDE4IDE4LTE4IDE4em0tNTQgMThsMTgtMTcgMTggMTctMTggMTh6bTU1LTUzbDE4LTE4IDE4IDE4LTE4IDE4em05MyA0OGwtOC04Yy00LTUtMTEtNS0xNiAwTDEwMyAyMDFjLTQgNC00IDExIDAgMTVsOCA4Yy00LTQtNC0xMSAwLTE1bDEwMS0xMDFjNS00IDEyLTQgMTYgMHoiLz48cGF0aCBmaWxsPSIjOWVlIiBkPSJNMjcgMTMxbDE4LTE4IDE4IDE4LTE4IDE4em01NC01M2wxOC0xOCAxOCAxOC0xOCAxOHoiLz48cGF0aCBmaWxsPSIjMGFhIiBkPSJNMjMwIDExMGwxMyAxM2M0IDQgNCAxMSAwIDE2TDE0MiAyNDBjLTQgNC0xMSA0LTE1IDBsLTEzLTEzYzQgNCAxMSA0IDE1IDBsMTAxLTEwMWM1LTUgNS0xMSAwLTE2eiIvPjxwYXRoIGZpbGw9IiMxYWIiIGQ9Ik0xMzQgMjQ4Yy00IDAtOC0yLTExLTVsLTIzLTIzYTE2IDE2IDAgMDEwLTIzTDIwMSA5NmExNiAxNiAwIDAxMjIgMGwyNCAyNGM2IDYgNiAxNiAwIDIyTDE0NiAyNDNjLTMgMy03IDUtMTIgNXptNzgtMTQ3bC00IDItMTAxIDEwMWE2IDYgMCAwMDAgOWwyMyAyM2E2IDYgMCAwMDkgMGwxMDEtMTAxYTYgNiAwIDAwMC05bC0yNC0yMy00LTJ6Ii8+PC9zdmc+ )](https://github.com/renovatebot/renovate)
2021-04-11 09:02:04 -04:00
[![GitHub last commit ](https://img.shields.io/github/last-commit/truecharts/apps?color=brightgreen&logoColor=white&style=for-the-badge )](https://github.com/truecharts/apps/commits)
2021-08-08 08:46:54 -04:00
2021-04-11 09:02:04 -04:00
---
2021-04-11 08:47:12 -04:00
2021-08-14 15:41:27 -04:00
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.
2021-04-11 08:47:12 -04:00
2021-04-11 09:02:04 -04:00
### Getting into creating Apps
2020-12-30 15:38:12 -05:00
2021-08-14 15:41:27 -04:00
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.
2020-12-30 15:38:12 -05:00
2021-06-14 18:09:40 -04:00
For more information on creating SCALE Apps and Helm charts, please check out our [development manual ](https://truecharts.org/ )
2021-04-11 08:36:39 -04:00
2021-04-11 09:02:04 -04:00
### Automation and you
2021-04-11 08:47:12 -04:00
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!
2021-08-14 15:41:27 -04:00
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!
2021-04-11 08:47:12 -04:00
2021-04-11 09:02:04 -04:00
< br >
2021-04-11 08:38:11 -04:00
## Contact and Support
2021-04-11 09:02:04 -04:00
[![Discord ](https://img.shields.io/badge/discord-chat-7289DA.svg?maxAge=60&style=for-the-badge )](https://discord.gg/tVsPTHWTtr)
2021-08-08 08:46:54 -04:00
2021-04-11 09:02:04 -04:00
---
2021-04-11 08:38:11 -04:00
To contact the TrueCharts project:
- Create an issue on [Github issues ](https://github.com/truecharts/apps/issues )
- Open a discussion on [GitHub Discussions ](https://github.com/truecharts/apps/discussions )
- Send us an [email ](mailto://info@truecharts.org )
- Or [join our Discord server ](https://truecharts.org/discord )
2021-04-11 09:02:04 -04:00
< br >
2021-04-11 09:46:26 -04:00
<!-- INSERT - DISCORD - WIDGET -->
< br >
2021-04-11 08:38:11 -04:00
2021-03-31 16:50:04 -04:00
## 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:
| < a href = "https://www.truenas.com/truenas-scale/" > < img src = "https://user-images.githubusercontent.com/7613738/113836934-a1764e00-978d-11eb-8e19-a087c5c1f99b.png" width = "150" height = "150" / > < / a > | < a href = "https://k8s-at-home.com/" > < img src = "https://user-images.githubusercontent.com/7613738/113837194-e26e6280-978d-11eb-9632-2e1529946302.png" width = "150" height = "150" / > < / a > | < a href = "https://traefik.io/traefik/" > < img src = "https://user-images.githubusercontent.com/7613738/113837353-0b8ef300-978e-11eb-873e-14769acfe1f1.png" width = "150" height = "150" / > < / a > |
| :---------------: | :---------------: | :---------------: |
| < a href = "https://www.truenas.com/truenas-scale/" > TrueNAS SCALE< / a > | < a href = "https://k8s-at-home.com/" > K8S-At-Home< / a > | < a href = "https://traefik.io/traefik/" > Traefik< / a > |
2021-04-11 09:02:04 -04:00
< br >
2021-03-31 16:50:04 -04:00
2021-04-09 17:20:18 -04:00
## Contributors ✨
2021-04-11 08:40:33 -04:00
<!-- ALL - CONTRIBUTORS - BADGE:START - Do not remove or modify this section -->
2021-05-06 13:36:35 -04:00
[![All Contributors ](https://img.shields.io/badge/all_contributors-14-orange.svg?style=for-the-badge )](#contributors)
2021-04-11 08:40:33 -04:00
<!-- ALL - CONTRIBUTORS - BADGE:END -->
2021-04-09 17:20:18 -04:00
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
2021-04-11 09:02:04 -04:00
---
2021-04-09 17:20:18 -04:00
<!-- ALL - CONTRIBUTORS - LIST:START - Do not remove or modify this section -->
<!-- prettier - ignore - start -->
<!-- markdownlint - disable -->
2021-04-09 17:22:26 -04:00
< table >
< tr >
< td align = "center" > < a href = "http://schouten-lebbing.nl" > < img src = "https://avatars.githubusercontent.com/u/7613738?v=4?s=100" width = "100px;" alt = "" / > < br / > < sub > < b > Kjeld Schouten-Lebbing< / b > < / sub > < / a > < br / > < a href = "https://github.com/truecharts/apps/commits?author=Ornias1993" title = "Code" > 💻< / a > < a href = "#infra-Ornias1993" title = "Infrastructure (Hosting, Build-Tools, etc)" > 🚇< / a > < a href = "https://github.com/truecharts/apps/commits?author=Ornias1993" title = "Documentation" > 📖< / a > < / td >
2021-04-09 17:40:07 -04:00
< td align = "center" > < a href = "http://sqlitebrowser.org" > < img src = "https://avatars.githubusercontent.com/u/406299?v=4?s=100" width = "100px;" alt = "" / > < br / > < sub > < b > Justin Clift< / b > < / sub > < / a > < br / > < a href = "https://github.com/truecharts/apps/commits?author=justinclift" title = "Documentation" > 📖< / a > < / td >
2021-04-09 17:38:55 -04:00
< td align = "center" > < a href = "https://github.com/whiskerz007" > < img src = "https://avatars.githubusercontent.com/u/2713522?v=4?s=100" width = "100px;" alt = "" / > < br / > < sub > < b > whiskerz007< / b > < / sub > < / a > < br / > < a href = "https://github.com/truecharts/apps/commits?author=whiskerz007" title = "Code" > 💻< / a > < / td >
2021-04-09 17:38:00 -04:00
< td align = "center" > < a href = "https://github.com/stavros-k" > < img src = "https://avatars.githubusercontent.com/u/47820033?v=4?s=100" width = "100px;" alt = "" / > < br / > < sub > < b > Stavros Kois< / b > < / sub > < / a > < br / > < a href = "https://github.com/truecharts/apps/commits?author=stavros-k" title = "Code" > 💻< / a > < a href = "https://github.com/truecharts/apps/commits?author=stavros-k" title = "Documentation" > 📖< / a > < / td >
2021-04-09 17:35:59 -04:00
< td align = "center" > < a href = "https://github.com/allen-4" > < img src = "https://avatars.githubusercontent.com/u/65494904?v=4?s=100" width = "100px;" alt = "" / > < br / > < sub > < b > allen-4< / b > < / sub > < / a > < br / > < a href = "https://github.com/truecharts/apps/commits?author=allen-4" title = "Code" > 💻< / a > < / td >
2021-04-09 17:34:42 -04:00
< td align = "center" > < a href = "https://github.com/tprelog" > < img src = "https://avatars.githubusercontent.com/u/35702532?v=4?s=100" width = "100px;" alt = "" / > < br / > < sub > < b > Troy Prelog< / b > < / sub > < / a > < br / > < a href = "https://github.com/truecharts/apps/commits?author=tprelog" title = "Code" > 💻< / a > < a href = "https://github.com/truecharts/apps/commits?author=tprelog" title = "Documentation" > 📖< / a > < / td >
2021-04-09 17:33:11 -04:00
< td align = "center" > < a href = "https://github.com/djs52" > < img src = "https://avatars.githubusercontent.com/u/1466018?v=4?s=100" width = "100px;" alt = "" / > < br / > < sub > < b > Dan Sheridan< / b > < / sub > < / a > < br / > < a href = "https://github.com/truecharts/apps/commits?author=djs52" title = "Code" > 💻< / a > < / td >
2021-04-10 09:39:22 -04:00
< / tr >
< tr >
2021-04-09 17:29:50 -04:00
< td align = "center" > < a href = "https://www.cetic.be/Sebastien-Dupont?lang=en" > < img src = "https://avatars.githubusercontent.com/u/2684865?v=4?s=100" width = "100px;" alt = "" / > < br / > < sub > < b > Sebastien Dupont< / b > < / sub > < / a > < br / > < a href = "https://github.com/truecharts/apps/commits?author=banzo" title = "Documentation" > 📖< / a > < / td >
2021-04-10 09:39:22 -04:00
< td align = "center" > < a href = "https://github.com/angelnu" > < img src = "https://avatars.githubusercontent.com/u/4406403?v=4?s=100" width = "100px;" alt = "" / > < br / > < sub > < b > Vegetto< / b > < / sub > < / a > < br / > < a href = "https://github.com/truecharts/apps/pulls?q=is%3Apr+reviewed-by%3Aangelnu" title = "Reviewed Pull Requests" > 👀< / a > < / td >
2021-04-12 06:12:26 -04:00
< td align = "center" > < a href = "http://nieuwdorp.me" > < img src = "https://avatars.githubusercontent.com/u/12896549?v=4?s=100" width = "100px;" alt = "" / > < br / > < sub > < b > Luuk Nieuwdorp< / b > < / sub > < / a > < br / > < a href = "https://github.com/truecharts/apps/commits?author=luuknieuwdorp" title = "Code" > 💻< / a > < / td >
2021-04-24 16:57:58 -04:00
< td align = "center" > < a href = "https://github.com/natewalck" > < img src = "https://avatars.githubusercontent.com/u/867868?v=4?s=100" width = "100px;" alt = "" / > < br / > < sub > < b > Nate Walck< / b > < / sub > < / a > < br / > < a href = "https://github.com/truecharts/apps/commits?author=natewalck" title = "Code" > 💻< / a > < / td >
2021-04-30 17:41:21 -04:00
< td align = "center" > < a href = "https://github.com/warllo54" > < img src = "https://avatars.githubusercontent.com/u/20650065?v=4?s=100" width = "100px;" alt = "" / > < br / > < sub > < b > Lloyd< / b > < / sub > < / a > < br / > < a href = "https://github.com/truecharts/apps/commits?author=warllo54" title = "Code" > 💻< / a > < / td >
2021-05-02 05:45:34 -04:00
< td align = "center" > < a href = "https://github.com/dwithnall" > < img src = "https://avatars.githubusercontent.com/u/5699800?v=4?s=100" width = "100px;" alt = "" / > < br / > < sub > < b > Dave Withnall< / b > < / sub > < / a > < br / > < a href = "https://github.com/truecharts/apps/commits?author=dwithnall" title = "Documentation" > 📖< / a > < / td >
2021-05-06 13:36:35 -04:00
< td align = "center" > < a href = "https://github.com/ksimm1" > < img src = "https://avatars.githubusercontent.com/u/1334526?v=4?s=100" width = "100px;" alt = "" / > < br / > < sub > < b > ksimm1< / b > < / sub > < / a > < br / > < a href = "https://github.com/truecharts/apps/commits?author=ksimm1" title = "Documentation" > 📖< / a > < / td >
2021-04-09 17:22:26 -04:00
< / tr >
< / table >
2021-04-09 17:20:18 -04:00
<!-- markdownlint - restore -->
<!-- prettier - ignore - end -->
<!-- ALL - CONTRIBUTORS - LIST:END -->
This project follows the [all-contributors ](https://github.com/all-contributors/all-contributors ) specification. Contributions of any kind welcome!
2021-04-11 08:23:17 -04:00
2020-12-30 15:38:12 -05:00
2021-04-11 09:02:04 -04:00
## Licence
2021-03-31 16:50:04 -04:00
[![License ](https://img.shields.io/badge/License-BSD%203--Clause-orange.svg?style=for-the-badge )](https://github.com/truecharts/apps/blob/master/docs/LICENSE.BSD3)
2021-08-08 08:46:54 -04:00
2021-04-11 09:02:04 -04:00
---
2020-12-30 15:38:12 -05:00
2021-08-14 15:41:27 -04:00
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.
2021-02-15 04:44:12 -05:00
2021-03-03 08:56:22 -05:00
Some Apps may also contain parts in other licenses, such as libraries or templates, these files can be recognised by their individual headers.
2021-02-25 11:09:50 -05:00
2021-03-31 16:50:04 -04:00
`SPDX-License-Identifier: BSD-3-Clause`
2021-02-25 11:09:50 -05:00
---
![built-with-resentment ](http://forthebadge.com/images/badges/built-with-resentment.svg ) ![contains-technical-debt ](http://forthebadge.com/images/badges/contains-technical-debt.svg )