3.0 KiB
Storage
TrueCharts uses multiple different storage systems:
Storage types
Storage is currently seperated into two types:
- Integrated Persistent Storage
- Custom Storage aka "hostPathMounts"
Integrated Persistent Storage
Integrated Persistent Storage is based around Kubernetes PVC's to integrate as closely as possible into TrueNAS SCALE. They are also heavily preconfigured to work as optimal as possible and provide options for future expansion such as NFS and Gluster options being added.
These storage options inherently are not well suited to being shared with multiple applications.
We currently have the following Storage options for Integrated Persistent Storage storage:
- Internal
Internal
This storage is integrated into TrueNAS SCALE and completely supports reverting upgrades. Thats why this is the default (and only actually supported!) way of storing App configuration files.
Custom app storage aka "hostPathMounts"
Besides the earlier mentioned Integrated Persistent Storage, we also provide the option to mount as many host folders as you want.
hostPathMounts are actually quite simple: It mounts a directory from your TrueNAS SCALE system, directly to a directory inside the App you're installing.
Permissions
Permission settings are rather important and are often something that causes issues for users. For both Integrated Persistent Storage and Custom storage, we offer special options to automatically set permissions to coincide with your container.
Integrated Persistent Storage
These get automatically set to be owned by root:PGID There are no options available to configure this.
Custom app storage aka "hostPathMounts"
We offer an optional automatic set the permissions according to App PGID and PUID.
Setting permissions automatically means we chown the folder and all folder within it, to a user and group of your choice.
However, we only do so when installing or updating an app.
Please be aware that automatically setting ownership/permissions, does mean it overrides your current CHOWN and CHMOD settings. This could break things and yes, it will destroy your system if used carelessly. It's also not wise to enable the automatic permissions on mounted shares from an external system.
These permission get based on the user and group you enter in the App configuration dialog and default to 568 (the SCALE default Apps user).
Depricated Storage systems
ix_volumes
ix_volumes, where the default storage option for every TrueCharts App before 21.04ALPHA. They always got created and used unless "hostPath" was checked. ix_volumes where fully managed by TrueNAS SCALE, they got created and destroyed on demand when creating, updating or editing an App. But, most importantly, they could be reverted if an upgrade goes wrong. Which makes them an great to use for storing config files.
They are, normally, stored in the following directory:
/mnt/poolname/ix-applications/releases/releasename/volumes/ix_volumes/