From 76c4ca5ccf5fd31d9b79d1e16b10dbf10a994bc9 Mon Sep 17 00:00:00 2001 From: Gmer4Lfe Date: Sun, 2 Aug 2026 00:17:41 -0400 Subject: [PATCH] Correct api_key_renew schedule in System_Essentials README It is listed in WATCHDOG_ORCHESTRATOR_SCRIPTS as well as ARRAY_START_SCRIPTS, so the claim that nothing in this folder runs on a timer was wrong. --- .../System_Essentials/README-System_Essentials.md | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/Plugin/unraid/System_Essentials/README-System_Essentials.md b/Plugin/unraid/System_Essentials/README-System_Essentials.md index f0f6580..d0e079f 100644 --- a/Plugin/unraid/System_Essentials/README-System_Essentials.md +++ b/Plugin/unraid/System_Essentials/README-System_Essentials.md @@ -10,12 +10,15 @@ There is no platform-agnostic version of any of them. On TrueNAS there is no mov | Script | Runs | Role | |--------|------|------| | `php_fpm_max_children.sh` | Array **start** | Raise the PHP-FPM worker ceiling so the WebGUI stays responsive | -| `unraid_api_key_renew.sh` | Array **start** | Re-register Varaverk's key in the ephemeral unraid-api registry | +| `unraid_api_key_renew.sh` | Array **start** + every **15 min** | Re-register Varaverk's key in the ephemeral unraid-api registry | | `user_scripts_stop.sh` | Array **stop** | Stop User Scripts processes before the array goes down | | `mover_stop.sh` | Array **stop** | Stop the mover gracefully before rsync or reboot | -All four are wired through `ARRAY_START_SCRIPTS` / `ARRAY_STOP_SCRIPTS` in `master.conf` — -none are on a timer. +All four are wired through `ARRAY_START_SCRIPTS` / `ARRAY_STOP_SCRIPTS` in `master.conf`. + +`unraid_api_key_renew.sh` is additionally listed in `WATCHDOG_ORCHESTRATOR_SCRIPTS`, so it also +re-runs every 15 minutes. That is deliberate: the registry it repairs can be cleared by a +service restart at any time, not only across a reboot, and the script is idempotent. --- @@ -123,7 +126,7 @@ for a window. | Variable | Used by | Purpose | |----------|---------|---------| -| `HOST*_UNRAID_API_KEY` | `unraid_api_key_renew.sh` | Written every array start — output, not input | +| `HOST*_UNRAID_API_KEY` | `unraid_api_key_renew.sh` | Written at array start and every 15 min — output, not input | | `MOVER_STOP_TIMEOUT` | `mover_stop.sh` | SIGTERM grace window before escalating | | `PHP_MAX_CHILDREN` | `php_fpm_max_children.sh` | Target worker ceiling |