HeavySetup - Further In-Depth Explanation
Flag | Example | Parameter | Description |
---|---|---|---|
NULL | NULL | NULL | If you choose not to supply an option, it will open the menu for easier access to the utilities |
--self-update | --self-update | None | Updates HeavyScript prior to running it You no longer need to git pull |
--delete-backup | --delete-backup | None | Opens a menu to delete backups Useful if you need to delete old system backups or backups from other scripts |
--restore | --restore | None | Restore HeavyScript specific ix-applications dataset snapshot |
--mount | --mount | None | Initiates mounting feature Choose between unmounting and mounting PVC data |
--dns | --dns | None | list all of your applications DNS names and their web ports |
-U | -U -U 5 |
None or Integer | Update applications, ignoring major version changes Optionally, you can supply a number after the argument to update multiple applications at once |
-u | -u -u 5 |
None or Integer | Update applications, do NOT update if there was a major version change Optionally, you can supply a number after the argument to update multiple applications at once |
-b | -b 10 | Integer | Backup ix-appliactions datasetCreates backups up to the number you've chosen |
-i | -i nextcloud -i sonarr | String | Applications listed will be ignored during updating List one application after another as shown in the example |
-r | -r | None | Monitors applications after they update If the app does not become "ACTIVE" after either: The custom Timeout, or Default Timeout, rollback the application. |
-v | -v | None | Verbose Output Look at the bottom of this page for an example |
-S | -S | None | Shutdown the application prior to updating it |
-t | -t 150 | Integer | Set a custom timeout to be used with either:-m Time the script will wait for application to be "STOPPED" or -(u|U) Time the script will wait for application to be either "STOPPED" or "ACTIVE" |
-s | -s | None | Sync Catalogs prior to updating |
-p | -p | None | Prune old/unused docker images |
bash heavy_script.sh --self-update -b 10 -i portainer -i arch -i sonarr -i radarr -t 600 -rsp -u 5
-b
is set to 10. Up to 10 snapshots of your ix-applications dataset will be saved
-i
is set to ignore portainer, arch, sonarr, and radarr. These applications will be ignored when it comes to updates.
-t
I set it to 600 seconds, this means the script will wait 600 seconds for the application to become ACTIVE before timing out and continuing to a different application.
-r
Will rollback applications if they fail to deploy after updating.
-s
will just sync the repositories, ensuring you are downloading the latest updates.
-p
Prune docker images.
-u
update applications as long as the major version has absolutely no change, if it does have a change it will ask the user to update manually.The
5
after the-u
means up to 5 applications will be updating and monitored at one time
--self-update
Will update the script prior to running anything else.
bash /mnt/tank/scripts/heavy_script.sh -t 300 --mount
bash /mnt/tank/scripts/heavy_script/heavy_script.sh --restore
bash /mnt/tank/scripts/heavy_script/heavy_script.sh --delete-backup
bash /mnt/tank/scripts/heavy_script/heavy_script.sh --dns
bash /mnt/speed/scripts/heavy_script/heavy_script.sh --self-update -b 10 -rsp -u 10
I created a scripts
dataset on my Truenas SCALE system, this is where all my scripts will remain.
Change Directory to your scripts folder
cd /mnt/speed/scripts
Git Clone Heavy_Script
git clone https://github.com/Heavybullets8/heavy_script.git
Change Directory to Heavy_Script folder
cd heavy_script
From here, you can just run Heavy_Script with bash heavy_script.sh -ARGUMENTS
Note:
chmod +x
is NOT required. Doing this will break thegit pull
(or self update) function. Just run the script withbash heavy_script.sh
Change Directory to your heavy_script folder
cd /mnt/speed/scripts/heavy_script
git pull
git pull
bash heavyscript.sh --self-update -b 10 -supr
The important argument here is the
--self-update
, you can still use all of your same arguments with this option.
- TrueNAS SCALE GUI
- System Settings
- Advanced
- Cron Jobs
- Click Add
Name | Value | Reason |
---|---|---|
Description |
HeavyScript git pull and Update apps | This is up to you, put whatever you think is a good description in here |
Command |
bash /PATH/TO/HEAVY_SCRIPT_DIRECTORY/heavy_script.sh --self-update -b 10 -rsup |
This is the command you will be running on your schedule I personally use: bash /mnt/speed/scripts/heavy_script/heavy_script.sh --self-update -b 10 -rsup |
Run As User |
root |
Running the script as root is REQUIRED. You cannot access all of the kubernetes functions without this user. |
Schedule |
Up to you, I run mine everyday at 0400 |
Again up to you |
Hide Standard Output |
False or Unticked |
I like to receive an email report of how the script ran, what apps updated etc. |
Hide Standard Error |
False or Unticked |
I want to see any errors that occur |
Enabled |
True or Ticked |
This will Enable the script to run on your schedule |
- Verbose used
bash heavy_script.sh -b 5 -Srupv
- Non-Verbose used
bash heavy_script.sh -b 5 -Srup
Verbose | Non-Verbose |
---|---|
![]() |
![]() |