Community Helm Chart Repository
Go to file
renovate[bot] 9629f15f35
[0.1.1] Update Helm chart common to v1 (#115)
* [0.1.1] Update Helm chart common to v1

* Update-Folder-Names-and-Dependencies

Co-authored-by: Renovate Bot <bot@renovateapp.com>
Co-authored-by: renovate[bot] <renovate[bot]@users.noreply.github.com>
2021-02-16 15:09:58 +01:00
.github Describe storage risks in readme 2021-02-16 11:10:33 +01:00
.test Update and clean common chart 2021-02-08 16:10:14 +01:00
charts [0.1.1] Update Helm chart common to v1 (#115) 2021-02-16 15:09:58 +01:00
library Update common 3.0.1 (#112) 2021-02-16 14:19:50 +01:00
.gitignore Small Tests and repo fixes (#80) 2021-02-09 19:13:56 +01:00
.pre-commit-config.yaml Small Tests and repo fixes (#80) 2021-02-09 19:13:56 +01:00
Gemfile Add Chart Release System 2021-02-04 15:12:58 +01:00
LICENSE Update project documentation 2020-12-30 21:38:12 +01:00
features_capability.json Small Tests and repo fixes (#80) 2021-02-09 19:13:56 +01:00
update_dependencies Small Tests and repo fixes (#80) 2021-02-09 19:13:56 +01:00

.github/README.md

TrueCharts:
Community App Catalog for TrueNAS SCALE

GitHub last commit LicenseFOSSA Status

Truecharts is an innitiative to provide high quality Apps to use with the TrueNAS SCALE App Ecosystem. Our primary goals are:

  • Freedom
  • Stability
  • Consistancy

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, still requires the CLI. However it's not hard:

  • Go to you shell of choice (either SSH or the TrueNAS webui shell)
  • enter cli
  • enter app catalog create repository="https://github.com/truecharts/truecharts" label="TrueCharts"

FAQ

  • Q: Please include app X
    A: Please file an issue about it, after checking the wiki to make sure it hasn't been discussed already: https://github.com/truecharts/truecharts/wiki/k8s-at-home-to-SCALE-App-migration-list

  • Q: Isn't there more documentation for app x
    A: No, currently during TrueNAS SCALE ALPHA/BETA we focus on the technical aspects.

  • Q: Function x doesn't seem to be working, should it be working?
    A: Maybe, please file an issue

  • Q: I'm missing a lot of configuration opions in the install GUI.
    A: We try to aim for a balance in the amount of options vs the simplicity of installation. Suggestions are always welcome

  • Q: The portal button isn't working.
    A: Portal buttons are current't not implemented very well and are considered "not supported" for the time being

  • Q: I selected letsencrypt but still get a traefik certificate.
    A: Cert Manager might take up to 10 minutes to fetch the right certificate and requires free access to 1.1.1.1:53. Until the right certificate is fetched, it will use the Traefik Default cert.

  • Q: Is my data guaranteed to be secure?
    A: ix_volumes (the auto generated storage) is considered relatively secure as long as you don't delete the App, but we can't give an absolute guarantee. data mounted using a hostPath, is as secure as the application that is using the data, our charts do not actively alter said dataset/folder. However: SCALE is still ALPHA, so breaking changes in the storage design are very likely.

Getting into creating Apps

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

The specifications of TrueNAS SCALE apps, is layed out in the wiki

Licence

SPDX-License-Identifier: BSD-3-Clause

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 rootfolder.

FOSSA Status