Go to file
kjeld Schouten-Lebbing c43251f390
docs update with warning
2022-01-20 17:04:21 +01:00
.github/workflows tweak commandline access 2022-01-16 15:59:43 +01:00
tests cleaunup 2022-01-16 15:37:21 +01:00
truetool docs update with warning 2022-01-20 17:04:21 +01:00
.gitignore setup repo 2022-01-16 15:33:26 +01:00
LICENSE Initial commit 2022-01-16 15:11:49 +01:00
README.md add backup restore feature and bump to 3.0.0 to surpass TrueUpdate 2022-01-20 16:26:24 +01:00
setup.py docs update with warning 2022-01-20 17:04:21 +01:00

truetool

A easy tool for frequently used TrueNAS SCALE CLI utilities. Previously known as "trueupdate"

How to install

run pip install truetool

Please be aware you will need to reinstall after every SCALE update

How to Update

run pip install --upgrade truetool

How to use

running truetool should be a good start.

Additional options are available:

Help

  • truetool -h for the CLI help page

Update

  • truetool -u or truetool --update updates TrueNAS SCALE Apps

  • truetool --catalog CATALOGNAME where CATALOGNAME is the name of the catalog you want to process in caps

  • truetool --versioning SCHEME where SCHEME is the highest semver version you want to process. options: patch, minor and major

  • truetool -a or truetool --all updates both active (running) and non-active (stuck or stopped) Apps

Backup

  • truetool -b or truetool --backup backup the complete Apps system prior to updates. Deletes old backups prior, number of old backups can be set, 14 by default
  • truetool -r or truetool --restore restores a specific backup by name
  • truetool -d or truetool --delete deletes a specific backup by name

Other

  • truetool -s or truetool --sync to sync the catalogs before running updates
  • truetool -p or truetool --prune to prune (remove) old docker images after running auto-update

Important note

Please use the above arguments seperatly, combining them might not work as you would expect. So use: truetool -u -b -p -s -a not: truetool -ubpsa