Add truenas-vm (vm)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

CHANGELOG.md

@@ -404,6 +404,14 @@ Exercise vigilance regarding copycat or coat-tailing sites that seek to exploit
 
 </details>
 
+## 2026-02-18
+
+### 💾 Core
+
+  - #### ✨ New Features
+
+    - core: Execution ID & Telemetry Improvements [@MickLesk](https://github.com/MickLesk) ([#12041](https://github.com/community-scripts/ProxmoxVE/pull/12041))
+
 ## 2026-02-17
 
 ### 🆕 New Scripts
@@ -414,6 +422,7 @@ Exercise vigilance regarding copycat or coat-tailing sites that seek to exploit
 
   - #### 🐞 Bug Fixes
 
+    - [Hotfix] Cleanuparr: backup config before update [@vhsdream](https://github.com/vhsdream) ([#12039](https://github.com/community-scripts/ProxmoxVE/pull/12039))
     - fix: pterodactyl-panel add symlink [@CrazyWolf13](https://github.com/CrazyWolf13) ([#11997](https://github.com/community-scripts/ProxmoxVE/pull/11997))
 
 ### 💾 Core
@@ -424,14 +433,23 @@ Exercise vigilance regarding copycat or coat-tailing sites that seek to exploit
 
   - #### ✨ New Features
 
+    - tools/pve: add data analytics / formatting / linting [@MickLesk](https://github.com/MickLesk) ([#12034](https://github.com/community-scripts/ProxmoxVE/pull/12034))
     - core: smart recovery for failed installs | extend exit_codes  [@MickLesk](https://github.com/MickLesk) ([#11221](https://github.com/community-scripts/ProxmoxVE/pull/11221))
 
+  - #### 🔧 Refactor
+
+    - core: error-handler improvements | better exit_code handling | better tools.func source check [@MickLesk](https://github.com/MickLesk) ([#12019](https://github.com/community-scripts/ProxmoxVE/pull/12019))
+
 ### 🧰 Tools
 
   - #### 🔧 Refactor
 
     - Immich Public Proxy: centralize and fix systemd service creation [@MickLesk](https://github.com/MickLesk) ([#12025](https://github.com/community-scripts/ProxmoxVE/pull/12025))
 
+### 📚 Documentation
+
+  - fix contribution/setup-fork [@andreasabeck](https://github.com/andreasabeck) ([#12047](https://github.com/community-scripts/ProxmoxVE/pull/12047))
+
 ## 2026-02-16
 
 ### 🆕 New Scripts

ct/cleanuparr.sh

@@ -32,8 +32,17 @@ function update_script() {
     systemctl stop cleanuparr
     msg_ok "Stopped Service"
 
+    msg_info "Backing up config"
+    cp -r /opt/cleanuparr/config /opt/cleanuparr_config_backup
+    msg_ok "Backed up config"
+
     CLEAN_INSTALL=1 fetch_and_deploy_gh_release "Cleanuparr" "Cleanuparr/Cleanuparr" "prebuild" "latest" "/opt/cleanuparr" "*linux-amd64.zip"
 
+    msg_info "Restoring config"
+    [[ -d /opt/cleanuparr/config ]] && rm -rf /opt/cleanuparr/config
+    mv /opt/cleanuparr_config_backup /opt/cleanuparr/config
+    msg_ok "Restored config"
+
     msg_info "Starting Service"
     systemctl start cleanuparr
     msg_ok "Started Service"

docs/contribution/setup-fork.sh

@@ -134,7 +134,7 @@ update_links() {
   # Find all files containing the old repo reference
   while IFS= read -r file; do
     # Count occurrences
-    local count=$(grep -c "github.com/$old_repo/$old_name" "$file" 2>/dev/null || echo 0)
+    local count=$(grep -E -c "(github.com|githubusercontent.com)/$old_repo/$old_name" "$file" 2>/dev/null || echo 0)
 
     if [[ $count -gt 0 ]]; then
       # Backup original
@@ -143,16 +143,16 @@ update_links() {
       # Replace links - use different sed syntax for BSD/macOS vs GNU sed
       if sed --version &>/dev/null 2>&1; then
         # GNU sed
-        sed -i "s|github.com/$old_repo/$old_name|github.com/$new_owner/$new_repo|g" "$file"
+        sed -E -i "s@(github.com|githubusercontent.com)/$old_repo/$old_name@\\1/$new_owner/$new_repo@g" "$file"
       else
         # BSD sed (macOS)
-        sed -i '' "s|github.com/$old_repo/$old_name|github.com/$new_owner/$new_repo|g" "$file"
+        sed -E -i '' "s@(github.com|githubusercontent.com)/$old_repo/$old_name@\\1/$new_owner/$new_repo@g" "$file"
       fi
 
       ((files_updated++))
       print_success "Updated $file ($count links)"
     fi
-  done < <(find "$search_path" -type f \( -name "*.md" -o -name "*.sh" -o -name "*.func" -o -name "*.json" \) -not -path "*/.git/*" 2>/dev/null | xargs grep -l "github.com/$old_repo/$old_name" 2>/dev/null)
+  done < <(find "$search_path" -type f \( -name "*.md" -o -name "*.sh" -o -name "*.func" -o -name "*.json" \) -not -path "*/.git/*" 2>/dev/null | xargs grep -E -l "(github.com|githubusercontent.com)/$old_repo/$old_name" 2>/dev/null)
 
   return $files_updated
 }

frontend/public/json/github-versions.json

@@ -1,5 +1,5 @@
 {
-  "generated": "2026-02-17T06:22:06Z",
+  "generated": "2026-02-18T06:25:03Z",
   "versions": [
     {
       "slug": "2fauth",
@@ -158,9 +158,9 @@
     {
       "slug": "bookstack",
       "repo": "BookStackApp/BookStack",
-      "version": "v25.12.3",
+      "version": "v25.12.5",
       "pinned": false,
-      "date": "2026-01-29T15:29:25Z"
+      "date": "2026-02-17T18:42:47Z"
     },
     {
       "slug": "byparr",
@@ -207,9 +207,9 @@
     {
       "slug": "comfyui",
       "repo": "comfyanonymous/ComfyUI",
-      "version": "v0.13.0",
+      "version": "v0.14.2",
       "pinned": false,
-      "date": "2026-02-10T20:27:38Z"
+      "date": "2026-02-18T06:12:02Z"
     },
     {
       "slug": "commafeed",
@@ -221,9 +221,9 @@
     {
       "slug": "configarr",
       "repo": "raydak-labs/configarr",
-      "version": "v1.20.0",
+      "version": "v1.21.0",
       "pinned": false,
-      "date": "2026-01-10T21:25:47Z"
+      "date": "2026-02-17T22:59:07Z"
     },
     {
       "slug": "convertx",
@@ -253,6 +253,13 @@
       "pinned": false,
       "date": "2026-02-11T15:39:05Z"
     },
+    {
+      "slug": "databasus",
+      "repo": "databasus/databasus",
+      "version": "v3.14.0",
+      "pinned": false,
+      "date": "2026-02-17T17:18:34Z"
+    },
     {
       "slug": "dawarich",
       "repo": "Freika/dawarich",
@@ -550,9 +557,9 @@
     {
       "slug": "huntarr",
       "repo": "plexguide/Huntarr.io",
-      "version": "9.2.4.1",
+      "version": "9.3.3",
       "pinned": false,
-      "date": "2026-02-12T22:17:47Z"
+      "date": "2026-02-18T02:35:29Z"
     },
     {
       "slug": "immich-public-proxy",
@@ -578,16 +585,16 @@
     {
       "slug": "invoiceninja",
       "repo": "invoiceninja/invoiceninja",
-      "version": "v5.12.62",
+      "version": "v5.12.63",
       "pinned": false,
-      "date": "2026-02-17T03:23:48Z"
+      "date": "2026-02-18T00:32:09Z"
     },
     {
       "slug": "jackett",
       "repo": "Jackett/Jackett",
-      "version": "v0.24.1140",
+      "version": "v0.24.1147",
       "pinned": false,
-      "date": "2026-02-17T05:54:25Z"
+      "date": "2026-02-18T05:54:19Z"
     },
     {
       "slug": "jellystat",
@@ -697,9 +704,9 @@
     {
       "slug": "leantime",
       "repo": "Leantime/leantime",
-      "version": "v3.6.2",
+      "version": "v3.7.0",
       "pinned": false,
-      "date": "2026-01-29T16:37:00Z"
+      "date": "2026-02-18T00:02:31Z"
     },
     {
       "slug": "librenms",
@@ -739,9 +746,9 @@
     {
       "slug": "linkstack",
       "repo": "linkstackorg/linkstack",
-      "version": "v4.8.4",
+      "version": "v4.8.6",
       "pinned": false,
-      "date": "2024-12-10T15:14:34Z"
+      "date": "2026-02-17T16:53:47Z"
     },
     {
       "slug": "linkwarden",
@@ -781,9 +788,9 @@
     {
       "slug": "mail-archiver",
       "repo": "s1t5/mail-archiver",
-      "version": "2602.1",
+      "version": "2602.2",
       "pinned": false,
-      "date": "2026-02-11T06:23:11Z"
+      "date": "2026-02-17T09:46:52Z"
     },
     {
       "slug": "managemydamnlife",
@@ -886,9 +893,9 @@
     {
       "slug": "netbox",
       "repo": "netbox-community/netbox",
-      "version": "v4.5.2",
+      "version": "v4.5.3",
       "pinned": false,
-      "date": "2026-02-03T13:54:26Z"
+      "date": "2026-02-17T15:39:18Z"
     },
     {
       "slug": "nextcloud-exporter",
@@ -1089,9 +1096,9 @@
     {
       "slug": "planka",
       "repo": "plankanban/planka",
-      "version": "v2.0.0",
+      "version": "v2.0.1",
       "pinned": false,
-      "date": "2026-02-11T13:50:10Z"
+      "date": "2026-02-17T15:26:55Z"
     },
     {
       "slug": "plant-it",
@@ -1103,9 +1110,9 @@
     {
       "slug": "pocketbase",
       "repo": "pocketbase/pocketbase",
-      "version": "v0.36.3",
+      "version": "v0.36.4",
       "pinned": false,
-      "date": "2026-02-13T18:38:58Z"
+      "date": "2026-02-17T08:02:51Z"
     },
     {
       "slug": "pocketid",
@@ -1236,9 +1243,9 @@
     {
       "slug": "rclone",
       "repo": "rclone/rclone",
-      "version": "v1.73.0",
+      "version": "v1.73.1",
       "pinned": false,
-      "date": "2026-01-30T22:12:03Z"
+      "date": "2026-02-17T18:27:21Z"
     },
     {
       "slug": "rdtclient",
@@ -1334,9 +1341,9 @@
     {
       "slug": "semaphore",
       "repo": "semaphoreui/semaphore",
-      "version": "v2.17.2",
+      "version": "v2.17.5",
       "pinned": false,
-      "date": "2026-02-16T10:27:40Z"
+      "date": "2026-02-17T18:20:38Z"
     },
     {
       "slug": "shelfmark",
@@ -1544,9 +1551,9 @@
     {
       "slug": "tunarr",
       "repo": "chrisbenincasa/tunarr",
-      "version": "v1.1.13",
+      "version": "v1.1.14",
       "pinned": false,
-      "date": "2026-02-16T16:16:17Z"
+      "date": "2026-02-17T18:26:17Z"
     },
     {
       "slug": "uhf",

frontend/public/json/truenas-vm.json

@@ -0,0 +1,40 @@
+{
+  "name": "TrueNAS Community Edition",
+  "slug": "truenas-community-edition",
+  "categories": [
+    2
+  ],
+  "date_created": "2026-01-16",
+  "type": "vm",
+  "updateable": false,
+  "privileged": false,
+  "interface_port": null,
+  "documentation": "https://www.truenas.com/docs/",
+  "website": "https://www.truenas.com/truenas-community-edition/",
+  "logo": "https://cdn.jsdelivr.net/gh/selfhst/icons@main/webp/truenas-core.webp",
+  "config_path": "",
+  "description": "TrueNAS Community Edition is the world's most deployed storage software. Free, flexible and build on OpenZFS with Docker.",
+  "install_methods": [
+    {
+      "type": "default",
+      "script": "vm/truenas-vm.sh",
+      "resources": {
+        "cpu": 2,
+        "ram": 8192,
+        "hdd": 16,
+        "os": "Debian",
+        "version": null
+      }
+    }
+  ],
+  "default_credentials": {
+    "username": null,
+    "password": null
+  },
+  "notes": [
+    {
+      "text": "Once the script finishes, proceed with the OS installation via the console. For more details, please refer to this discussion: `https://github.com/community-scripts/ProxmoxVE/discussions/11344`",
+      "type": "info"
+    }
+  ]
+}

misc/alpine-install.func

@@ -11,6 +11,13 @@ source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxV
 load_functions
 catch_errors
 
+# Persist diagnostics setting inside container (exported from build.func)
+# so addon scripts running later can find the user's choice
+if [[ ! -f /usr/local/community-scripts/diagnostics ]]; then
+  mkdir -p /usr/local/community-scripts
+  echo "DIAGNOSTICS=${DIAGNOSTICS:-no}" >/usr/local/community-scripts/diagnostics
+fi
+
 # Get LXC IP address (must be called INSIDE container, after network is up)
 get_lxc_ip
 
@@ -30,7 +37,7 @@ post_progress_to_api() {
 
   curl -fsS -m 5 -X POST "https://telemetry.community-scripts.org/telemetry" \
     -H "Content-Type: application/json" \
-    -d "{\"random_id\":\"${RANDOM_UUID}\",\"type\":\"lxc\",\"nsapp\":\"${app:-unknown}\",\"status\":\"configuring\"}" &>/dev/null || true
+    -d "{\"random_id\":\"${RANDOM_UUID}\",\"execution_id\":\"${EXECUTION_ID:-${RANDOM_UUID}}\",\"type\":\"lxc\",\"nsapp\":\"${app:-unknown}\",\"status\":\"configuring\"}" &>/dev/null || true
 }
 
 # This function enables IPv6 if it's not disabled and sets verbose mode

misc/api.func

@@ -552,6 +552,7 @@ post_to_api() {
     cat <<EOF
 {
     "random_id": "${RANDOM_UUID}",
+    "execution_id": "${EXECUTION_ID:-${RANDOM_UUID}}",
     "type": "lxc",
     "nsapp": "${NSAPP:-unknown}",
     "status": "installing",
@@ -656,6 +657,7 @@ post_to_api_vm() {
     cat <<EOF
 {
     "random_id": "${RANDOM_UUID}",
+    "execution_id": "${EXECUTION_ID:-${RANDOM_UUID}}",
     "type": "vm",
     "nsapp": "${NSAPP:-unknown}",
     "status": "installing",
@@ -788,6 +790,7 @@ post_update_to_api() {
     cat <<EOF
 {
     "random_id": "${RANDOM_UUID}",
+    "execution_id": "${EXECUTION_ID:-${RANDOM_UUID}}",
     "type": "${TELEMETRY_TYPE:-lxc}",
     "nsapp": "${NSAPP:-unknown}",
     "status": "${pb_status}",
@@ -830,6 +833,7 @@ EOF
     cat <<EOF
 {
     "random_id": "${RANDOM_UUID}",
+    "execution_id": "${EXECUTION_ID:-${RANDOM_UUID}}",
     "type": "${TELEMETRY_TYPE:-lxc}",
     "nsapp": "${NSAPP:-unknown}",
     "status": "${pb_status}",
@@ -872,6 +876,7 @@ EOF
     cat <<EOF
 {
     "random_id": "${RANDOM_UUID}",
+    "execution_id": "${EXECUTION_ID:-${RANDOM_UUID}}",
     "type": "${TELEMETRY_TYPE:-lxc}",
     "nsapp": "${NSAPP:-unknown}",
     "status": "${pb_status}",
@@ -985,6 +990,63 @@ get_install_duration() {
   echo $((now - INSTALL_START_TIME))
 }
 
+# ------------------------------------------------------------------------------
+# _telemetry_report_exit()
+#
+# - Internal handler called by EXIT trap set in init_tool_telemetry()
+# - Determines success/failure from exit code and reports via appropriate API
+# - Arguments:
+#   * $1: exit_code from the script
+# ------------------------------------------------------------------------------
+_telemetry_report_exit() {
+  local ec="${1:-0}"
+  local status="success"
+  [[ "$ec" -ne 0 ]] && status="failed"
+
+  # Lazy name resolution: use explicit name, fall back to $APP, then "unknown"
+  local name="${TELEMETRY_TOOL_NAME:-${APP:-unknown}}"
+
+  if [[ "${TELEMETRY_TOOL_TYPE:-pve}" == "addon" ]]; then
+    post_addon_to_api "$name" "$status" "$ec"
+  else
+    post_tool_to_api "$name" "$status" "$ec"
+  fi
+}
+
+# ------------------------------------------------------------------------------
+# init_tool_telemetry()
+#
+# - One-line telemetry setup for tools/addon scripts
+# - Reads DIAGNOSTICS from /usr/local/community-scripts/diagnostics
+#   (persisted on PVE host during first build, and inside containers by install.func)
+# - Starts install timer for duration tracking
+# - Sets EXIT trap to automatically report success/failure on script exit
+# - Arguments:
+#   * $1: tool_name (optional, falls back to $APP at exit time)
+#   * $2: type ("pve" for PVE host scripts, "addon" for container addons)
+# - Usage:
+#   source <(curl -fsSL .../misc/api.func) 2>/dev/null || true
+#   init_tool_telemetry "post-pve-install" "pve"
+#   init_tool_telemetry "" "addon"  # uses $APP at exit time
+# ------------------------------------------------------------------------------
+init_tool_telemetry() {
+  local name="${1:-}"
+  local type="${2:-pve}"
+
+  [[ -n "$name" ]] && TELEMETRY_TOOL_NAME="$name"
+  TELEMETRY_TOOL_TYPE="$type"
+
+  # Read diagnostics opt-in/opt-out
+  if [[ -f /usr/local/community-scripts/diagnostics ]]; then
+    DIAGNOSTICS=$(grep -i "^DIAGNOSTICS=" /usr/local/community-scripts/diagnostics 2>/dev/null | awk -F'=' '{print $2}') || true
+  fi
+
+  start_install_timer
+
+  # EXIT trap: automatically report telemetry when script ends
+  trap '_telemetry_report_exit "$?"' EXIT
+}
+
 # ------------------------------------------------------------------------------
 # post_tool_to_api()
 #
@@ -1032,7 +1094,8 @@ post_tool_to_api() {
     cat <<EOF
 {
     "random_id": "${uuid}",
-    "type": "tool",
+    "execution_id": "${EXECUTION_ID:-${uuid}}",
+    "type": "pve",
     "nsapp": "${tool_name}",
     "status": "${status}",
     "exit_code": ${exit_code},
@@ -1099,6 +1162,7 @@ post_addon_to_api() {
     cat <<EOF
 {
     "random_id": "${uuid}",
+    "execution_id": "${EXECUTION_ID:-${uuid}}",
     "type": "addon",
     "nsapp": "${addon_name}",
     "status": "${status}",
@@ -1190,6 +1254,7 @@ post_update_to_api_extended() {
     cat <<EOF
 {
     "random_id": "${RANDOM_UUID}",
+    "execution_id": "${EXECUTION_ID:-${RANDOM_UUID}}",
     "type": "${TELEMETRY_TYPE:-lxc}",
     "nsapp": "${NSAPP:-unknown}",
     "status": "${pb_status}",

misc/build.func

@@ -42,9 +42,10 @@ variables() {
   var_install="${NSAPP}-install"                         # sets the var_install variable by appending "-install" to the value of NSAPP.
   INTEGER='^[0-9]+([.][0-9]+)?$'                         # it defines the INTEGER regular expression pattern.
   PVEHOST_NAME=$(hostname)                               # gets the Proxmox Hostname and sets it to Uppercase
-  DIAGNOSTICS="yes"                                      # sets the DIAGNOSTICS variable to "yes", used for the API call.
+  DIAGNOSTICS="no"                                       # Safe default: no telemetry until user consents via diagnostics_check()
   METHOD="default"                                       # sets the METHOD variable to "default", used for the API call.
   RANDOM_UUID="$(cat /proc/sys/kernel/random/uuid)"      # generates a random UUID and sets it to the RANDOM_UUID variable.
+  EXECUTION_ID="${RANDOM_UUID}"                          # Unique execution ID for telemetry record identification (unique-indexed in PocketBase)
   SESSION_ID="${RANDOM_UUID:0:8}"                        # Short session ID (first 8 chars of UUID) for log files
   BUILD_LOG="/tmp/create-lxc-${SESSION_ID}.log"          # Host-side container creation log
   combined_log="/tmp/install-${SESSION_ID}-combined.log" # Combined log (build + install) for failed installations
@@ -2787,93 +2788,85 @@ Advanced:
 # diagnostics_check()
 #
 # - Ensures diagnostics config file exists at /usr/local/community-scripts/diagnostics
-# - Asks user whether to send anonymous diagnostic data
+# - Asks user whether to send anonymous diagnostic data (first run only)
 # - Saves DIAGNOSTICS=yes/no in the config file
-# - Creates file if missing with default DIAGNOSTICS=yes
-# - Reads current diagnostics setting from file
+# - Reads current diagnostics setting from existing file
 # - Sets global DIAGNOSTICS variable for API telemetry opt-in/out
 # ------------------------------------------------------------------------------
 diagnostics_check() {
-  if ! [ -d "/usr/local/community-scripts" ]; then
-    mkdir -p /usr/local/community-scripts
+  local config_dir="/usr/local/community-scripts"
+  local config_file="${config_dir}/diagnostics"
+
+  mkdir -p "$config_dir"
+
+  if [[ -f "$config_file" ]]; then
+    DIAGNOSTICS=$(awk -F '=' '/^DIAGNOSTICS/ {print $2}' "$config_file") || true
+    DIAGNOSTICS="${DIAGNOSTICS:-no}"
+    return
   fi
 
-  if ! [ -f "/usr/local/community-scripts/diagnostics" ]; then
-    if (whiptail --backtitle "Proxmox VE Helper Scripts" --title "DIAGNOSTICS" --yesno "Send Diagnostics of LXC Installation?\n\n(This only transmits data without user data, just RAM, CPU, LXC name, ...)" 10 58); then
-      cat <<EOF >/usr/local/community-scripts/diagnostics
-DIAGNOSTICS=yes
+  local result
+  result=$(whiptail --backtitle "Proxmox VE Helper Scripts" \
+    --title "TELEMETRY & DIAGNOSTICS" \
+    --ok-button "Confirm" --cancel-button "Exit" \
+    --radiolist "\nHelp improve Community-Scripts by sharing anonymous data.\n\nWhat we collect:\n  - Container resources (CPU, RAM, disk), OS & PVE version\n  - Application name, install method and status\n\nWhat we DON'T collect:\n  - No IP addresses, hostnames, or personal data\n\nYou can change this anytime in the Settings menu.\nPrivacy: https://github.com/community-scripts/telemetry-service/blob/main/docs/PRIVACY.md\n\nUse SPACE to select, ENTER to confirm." 22 76 2 \
+    "yes" "Yes, share anonymous data" OFF \
+    "no" "No, opt out" OFF \
+    3>&1 1>&2 2>&3) || result="no"
 
-#This file is used to store the diagnostics settings for the Community-Scripts API.
-#https://github.com/community-scripts/ProxmoxVE/discussions/1836
-#Your diagnostics will be sent to the Community-Scripts API for troubleshooting/statistical purposes.
-#You can review the data at https://community-scripts.github.io/ProxmoxVE/data
-#If you do not wish to send diagnostics, please set the variable 'DIAGNOSTICS' to "no" in /usr/local/community-scripts/diagnostics, or use the menue.
-#This will disable the diagnostics feature.
-#To send diagnostics, set the variable 'DIAGNOSTICS' to "yes" in /usr/local/community-scripts/diagnostics, or use the menue.
-#This will enable the diagnostics feature.
-#The following information will be sent:
-#"disk_size"
-#"core_count"
-#"ram_size"
-#"os_type"
-#"os_version"
-#"nsapp"
-#"method"
-#"pve_version"
-#"status"
-#If you have any concerns, please review the source code at /misc/build.func
+  DIAGNOSTICS="${result:-no}"
+
+  cat <<EOF >"$config_file"
+DIAGNOSTICS=${DIAGNOSTICS}
+
+# Community-Scripts Telemetry Configuration
+# https://telemetry.community-scripts.org
+#
+# This file stores your telemetry preference.
+# Set DIAGNOSTICS=yes to share anonymous installation data.
+# Set DIAGNOSTICS=no to disable telemetry.
+#
+# You can also change this via the Settings menu during installation.
+#
+# Data collected (when enabled):
+#   disk_size, core_count, ram_size, os_type, os_version,
+#   nsapp, method, pve_version, status, exit_code
+#
+# No personal data (IPs, hostnames, passwords) is ever collected.
+# Privacy: https://github.com/community-scripts/telemetry-service/blob/main/docs/PRIVACY.md
 EOF
-      DIAGNOSTICS="yes"
-    else
-      cat <<EOF >/usr/local/community-scripts/diagnostics
-DIAGNOSTICS=no
-
-#This file is used to store the diagnostics settings for the Community-Scripts API.
-#https://github.com/community-scripts/ProxmoxVE/discussions/1836
-#Your diagnostics will be sent to the Community-Scripts API for troubleshooting/statistical purposes.
-#You can review the data at https://community-scripts.github.io/ProxmoxVE/data
-#If you do not wish to send diagnostics, please set the variable 'DIAGNOSTICS' to "no" in /usr/local/community-scripts/diagnostics, or use the menue.
-#This will disable the diagnostics feature.
-#To send diagnostics, set the variable 'DIAGNOSTICS' to "yes" in /usr/local/community-scripts/diagnostics, or use the menue.
-#This will enable the diagnostics feature.
-#The following information will be sent:
-#"disk_size"
-#"core_count"
-#"ram_size"
-#"os_type"
-#"os_version"
-#"nsapp"
-#"method"
-#"pve_version"
-#"status"
-#If you have any concerns, please review the source code at /misc/build.func
-EOF
-      DIAGNOSTICS="no"
-    fi
-  else
-    DIAGNOSTICS=$(awk -F '=' '/^DIAGNOSTICS/ {print $2}' /usr/local/community-scripts/diagnostics)
-
-  fi
 }
 
 diagnostics_menu() {
-  if [ "${DIAGNOSTICS:-no}" = "yes" ]; then
+  local current="${DIAGNOSTICS:-no}"
+  local status_text="DISABLED"
+  [[ "$current" == "yes" ]] && status_text="ENABLED"
+
+  local dialog_text=(
+    "Telemetry is currently: ${status_text}\n\n"
+    "Anonymous data helps us improve scripts and track issues.\n"
+    "No personal data is ever collected.\n\n"
+    "More info: https://telemetry.community-scripts.org\n\n"
+    "Do you want to ${current:+change this setting}?"
+  )
+
+  if [[ "$current" == "yes" ]]; then
     if whiptail --backtitle "Proxmox VE Helper Scripts" \
-      --title "DIAGNOSTIC SETTINGS" \
-      --yesno "Send Diagnostics?\n\nCurrent: ${DIAGNOSTICS}" 10 58 \
-      --yes-button "No" --no-button "Back"; then
+      --title "TELEMETRY SETTINGS" \
+      --yesno "${dialog_text[*]}" 14 64 \
+      --yes-button "Disable" --no-button "Keep enabled"; then
       DIAGNOSTICS="no"
       sed -i 's/^DIAGNOSTICS=.*/DIAGNOSTICS=no/' /usr/local/community-scripts/diagnostics
-      whiptail --msgbox "Diagnostics set to ${DIAGNOSTICS}." 8 58
+      whiptail --msgbox "Telemetry disabled.\n\nNote: Existing containers keep their current setting.\nNew containers will inherit this choice." 10 58
     fi
   else
     if whiptail --backtitle "Proxmox VE Helper Scripts" \
-      --title "DIAGNOSTIC SETTINGS" \
-      --yesno "Send Diagnostics?\n\nCurrent: ${DIAGNOSTICS}" 10 58 \
-      --yes-button "Yes" --no-button "Back"; then
+      --title "TELEMETRY SETTINGS" \
+      --yesno "${dialog_text[*]}" 14 64 \
+      --yes-button "Enable" --no-button "Keep disabled"; then
       DIAGNOSTICS="yes"
       sed -i 's/^DIAGNOSTICS=.*/DIAGNOSTICS=yes/' /usr/local/community-scripts/diagnostics
-      whiptail --msgbox "Diagnostics set to ${DIAGNOSTICS}." 8 58
+      whiptail --msgbox "Telemetry enabled.\n\nNote: Existing containers keep their current setting.\nNew containers will inherit this choice." 10 58
     fi
   fi
 }
@@ -3561,6 +3554,7 @@ build_container() {
   # Core exports for install.func
   export DIAGNOSTICS="$DIAGNOSTICS"
   export RANDOM_UUID="$RANDOM_UUID"
+  export EXECUTION_ID="$EXECUTION_ID"
   export SESSION_ID="$SESSION_ID"
   export CACHER="$APT_CACHER"
   export CACHER_IP="$APT_CACHER_IP"
@@ -4431,7 +4425,7 @@ EOF'
           export var_cpu="$CORE_COUNT"
           export VERBOSE="yes"
           export var_verbose="yes"
-          export RECOVERY_ATTEMPT=$(( ${RECOVERY_ATTEMPT:-0} + 1 ))
+          export RECOVERY_ATTEMPT=$((${RECOVERY_ATTEMPT:-0} + 1))
 
           echo -e "${YW}Rebuilding with increased resources (attempt ${RECOVERY_ATTEMPT}/2):${CL}"
           echo -e "  Container ID: ${old_ctid} → ${CTID}"
@@ -5552,6 +5546,8 @@ ensure_log_on_host() {
 # - Exit trap handler for reporting to API telemetry
 # - Captures exit code and reports to PocketBase using centralized error descriptions
 # - Uses explain_exit_code() from api.func for consistent error messages
+# - For signal exits (>128): sends telemetry FIRST before log collection
+#   to prevent pct pull hangs from blocking status updates
 # - For non-zero exit codes: posts "failed" status
 # - For zero exit codes where post_update_to_api was never called:
 #   catches orphaned "installing" records (e.g., script exited cleanly
@@ -5560,8 +5556,15 @@ ensure_log_on_host() {
 api_exit_script() {
   local exit_code=$?
   if [ $exit_code -ne 0 ]; then
-    ensure_log_on_host
-    post_update_to_api "failed" "$exit_code"
+    if [ $exit_code -gt 128 ]; then
+      # Signal exit: send telemetry IMMEDIATELY (container may be dying)
+      post_update_to_api "failed" "$exit_code" 2>/dev/null || true
+      ensure_log_on_host 2>/dev/null || true
+    else
+      # Normal error: collect logs first for better error details
+      ensure_log_on_host 2>/dev/null || true
+      post_update_to_api "failed" "$exit_code"
+    fi
   elif [[ "${POST_TO_API_DONE:-}" == "true" && "${POST_UPDATE_DONE:-}" != "true" ]]; then
     # Script exited with 0 but never sent a completion status
     # exit_code=0 is never an error — report as success
@@ -5572,7 +5575,7 @@ api_exit_script() {
 if command -v pveversion >/dev/null 2>&1; then
   trap 'api_exit_script' EXIT
 fi
-trap 'local _ec=$?; if [[ $_ec -ne 0 ]]; then ensure_log_on_host; post_update_to_api "failed" "$_ec"; fi' ERR
-trap 'ensure_log_on_host; post_update_to_api "failed" "129"; exit 129' SIGHUP
-trap 'ensure_log_on_host; post_update_to_api "failed" "130"; exit 130' SIGINT
-trap 'ensure_log_on_host; post_update_to_api "failed" "143"; exit 143' SIGTERM
+trap 'local _ec=$?; if [[ $_ec -ne 0 ]]; then ensure_log_on_host 2>/dev/null || true; post_update_to_api "failed" "$_ec"; fi' ERR
+trap 'post_update_to_api "failed" "129" 2>/dev/null || true; ensure_log_on_host 2>/dev/null || true; exit 129' SIGHUP
+trap 'post_update_to_api "failed" "130" 2>/dev/null || true; ensure_log_on_host 2>/dev/null || true; exit 130' SIGINT
+trap 'post_update_to_api "failed" "143" 2>/dev/null || true; ensure_log_on_host 2>/dev/null || true; exit 143' SIGTERM

misc/error_handler.func

@@ -329,6 +329,8 @@ error_handler() {
 # - Cleans up lock files if lockfile variable is set
 # - Exits with captured exit code
 # - Always runs on script termination (success or failure)
+# - For signal exits (>128): sends telemetry FIRST before log collection
+#   to prevent pct pull hangs from blocking status updates
 # ------------------------------------------------------------------------------
 on_exit() {
   local exit_code=$?
@@ -337,14 +339,24 @@ on_exit() {
   # post_to_api was called ("installing" sent) but post_update_to_api was never called
   if [[ "${POST_TO_API_DONE:-}" == "true" && "${POST_UPDATE_DONE:-}" != "true" ]]; then
     if declare -f post_update_to_api >/dev/null 2>&1; then
-      # Ensure log is accessible on host before reporting
-      if declare -f ensure_log_on_host >/dev/null 2>&1; then
-        ensure_log_on_host
-      fi
-      if [[ $exit_code -ne 0 ]]; then
-        post_update_to_api "failed" "$exit_code"
+      if [[ $exit_code -gt 128 ]]; then
+        # Signal exit: send telemetry IMMEDIATELY (container may be dying, pct pull could hang)
+        post_update_to_api "failed" "$exit_code" 2>/dev/null || true
+        # Then try log collection (non-critical, best-effort)
+        if declare -f ensure_log_on_host >/dev/null 2>&1; then
+          ensure_log_on_host 2>/dev/null || true
+        fi
       else
-        post_update_to_api "failed" "1"
+        # Normal exit: collect logs first for better error details
+        if declare -f ensure_log_on_host >/dev/null 2>&1; then
+          ensure_log_on_host 2>/dev/null || true
+        fi
+        if [[ $exit_code -ne 0 ]]; then
+          post_update_to_api "failed" "$exit_code"
+        else
+          # exit_code=0 is never an error — report as success
+          post_update_to_api "done" "0"
+        fi
       fi
     fi
   fi
@@ -356,22 +368,26 @@ on_exit() {
 # on_interrupt()
 #
 # - SIGINT (Ctrl+C) trap handler
+# - Reports to telemetry FIRST (time-critical: container may be dying)
 # - Displays "Interrupted by user" message
 # - Exits with code 130 (128 + SIGINT=2)
+# - Output redirected to /dev/null fallback to prevent SIGPIPE on closed terminals
 # ------------------------------------------------------------------------------
 on_interrupt() {
-  # Ensure log is accessible on host before reporting
-  if declare -f ensure_log_on_host >/dev/null 2>&1; then
-    ensure_log_on_host
-  fi
-  # Report interruption to telemetry API (prevents stuck "installing" records)
+  # CRITICAL: Send telemetry FIRST before any cleanup or output
+  # If ensure_log_on_host hangs (e.g. pct pull on dying container),
+  # the status update would never be sent, leaving records stuck in "installing"
   if declare -f post_update_to_api >/dev/null 2>&1; then
-    post_update_to_api "failed" "130"
+    post_update_to_api "failed" "130" 2>/dev/null || true
+  fi
+  # Best-effort log collection (non-critical after telemetry is sent)
+  if declare -f ensure_log_on_host >/dev/null 2>&1; then
+    ensure_log_on_host 2>/dev/null || true
   fi
   if declare -f msg_error >/dev/null 2>&1; then
-    msg_error "Interrupted by user (SIGINT)"
+    msg_error "Interrupted by user (SIGINT)" 2>/dev/null || true
   else
-    echo -e "\n${RD}Interrupted by user (SIGINT)${CL}"
+    echo -e "\n${RD}Interrupted by user (SIGINT)${CL}" 2>/dev/null || true
   fi
   exit 130
 }
@@ -380,23 +396,27 @@ on_interrupt() {
 # on_terminate()
 #
 # - SIGTERM trap handler
+# - Reports to telemetry FIRST (time-critical: process being killed)
 # - Displays "Terminated by signal" message
 # - Exits with code 143 (128 + SIGTERM=15)
 # - Triggered by external process termination
+# - Output redirected to /dev/null fallback to prevent SIGPIPE on closed terminals
 # ------------------------------------------------------------------------------
 on_terminate() {
-  # Ensure log is accessible on host before reporting
-  if declare -f ensure_log_on_host >/dev/null 2>&1; then
-    ensure_log_on_host
-  fi
-  # Report termination to telemetry API (prevents stuck "installing" records)
+  # CRITICAL: Send telemetry FIRST before any cleanup or output
+  # Same rationale as on_interrupt: ensure status gets reported even if
+  # ensure_log_on_host hangs or terminal is already closed
   if declare -f post_update_to_api >/dev/null 2>&1; then
-    post_update_to_api "failed" "143"
+    post_update_to_api "failed" "143" 2>/dev/null || true
+  fi
+  # Best-effort log collection (non-critical after telemetry is sent)
+  if declare -f ensure_log_on_host >/dev/null 2>&1; then
+    ensure_log_on_host 2>/dev/null || true
   fi
   if declare -f msg_error >/dev/null 2>&1; then
-    msg_error "Terminated by signal (SIGTERM)"
+    msg_error "Terminated by signal (SIGTERM)" 2>/dev/null || true
   else
-    echo -e "\n${RD}Terminated by signal (SIGTERM)${CL}"
+    echo -e "\n${RD}Terminated by signal (SIGTERM)${CL}" 2>/dev/null || true
   fi
   exit 143
 }

misc/install.func

@@ -37,6 +37,13 @@ source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxV
 load_functions
 catch_errors
 
+# Persist diagnostics setting inside container (exported from build.func)
+# so addon scripts running later can find the user's choice
+if [[ ! -f /usr/local/community-scripts/diagnostics ]]; then
+  mkdir -p /usr/local/community-scripts
+  echo "DIAGNOSTICS=${DIAGNOSTICS:-no}" >/usr/local/community-scripts/diagnostics
+fi
+
 # Get LXC IP address (must be called INSIDE container, after network is up)
 get_lxc_ip
 
@@ -56,7 +63,7 @@ post_progress_to_api() {
 
   curl -fsS -m 5 -X POST "https://telemetry.community-scripts.org/telemetry" \
     -H "Content-Type: application/json" \
-    -d "{\"random_id\":\"${RANDOM_UUID}\",\"type\":\"lxc\",\"nsapp\":\"${app:-unknown}\",\"status\":\"configuring\"}" &>/dev/null || true
+    -d "{\"random_id\":\"${RANDOM_UUID}\",\"execution_id\":\"${EXECUTION_ID:-${RANDOM_UUID}}\",\"type\":\"lxc\",\"nsapp\":\"${app:-unknown}\",\"status\":\"configuring\"}" &>/dev/null || true
 }
 
 # ==============================================================================

tools/addon/add-netbird-lxc.sh

@@ -19,6 +19,11 @@ EOF
 }
 header_info
 set -e
+
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "add-netbird-lxc" "addon"
+
 while true; do
   read -p "This will add NetBird to an existing LXC Container ONLY. Proceed(y/n)?" yn
   case $yn in

tools/addon/add-tailscale-lxc.sh

@@ -23,6 +23,10 @@ function msg_info() { echo -e " \e[1;36m➤\e[0m $1"; }
 function msg_ok() { echo -e " \e[1;32m✔\e[0m $1"; }
 function msg_error() { echo -e " \e[1;31m✖\e[0m $1"; }
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "add-tailscale-lxc" "addon"
+
 header_info
 
 if ! command -v pveversion &>/dev/null; then

tools/addon/adguardhome-sync.sh

@@ -13,6 +13,7 @@ fi
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/core.func)
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/tools.func)
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/error_handler.func)
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
 
 # Enable error handling
 set -Eeuo pipefail
@@ -29,6 +30,7 @@ DEFAULT_PORT=8080
 
 # Initialize all core functions (colors, formatting, icons, STD mode)
 load_functions
+init_tool_telemetry "" "addon"
 
 # ==============================================================================
 # HEADER

tools/addon/all-templates.sh

@@ -42,6 +42,11 @@ function msg() {
   local TEXT="$1"
   echo -e "$TEXT"
 }
+
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "all-templates" "addon"
+
 function validate_container_id() {
   local ctid="$1"
   # Check if ID is numeric

tools/addon/coder-code-server.sh

@@ -28,6 +28,11 @@ HOLD="-"
 CM="${GN}✓${CL}"
 APP="Coder Code Server"
 hostname="$(hostname)"
+
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "coder-code-server" "addon"
+
 set -o errexit
 set -o errtrace
 set -o nounset

tools/addon/copyparty.sh

@@ -13,11 +13,13 @@ fi
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/core.func)
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/tools.func)
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/error_handler.func)
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
 
 # Enable error handling
 set -Eeuo pipefail
 trap 'error_handler' ERR
 load_functions
+init_tool_telemetry "" "addon"
 
 # ==============================================================================
 # CONFIGURATION

tools/addon/crowdsec.sh

@@ -17,6 +17,11 @@ HOLD="-"
 CM="${GN}✓${CL}"
 APP="CrowdSec"
 hostname="$(hostname)"
+
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "crowdsec" "addon"
+
 set -o errexit
 set -o errtrace
 set -o nounset

tools/addon/filebrowser-quantum.sh

@@ -32,6 +32,10 @@ DEFAULT_PORT=8080
 SRC_DIR="/"
 TMP_BIN="/tmp/filebrowser.$$"
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "filebrowser-quantum" "addon"
+
 # Get primary IP
 IFACE=$(ip -4 route | awk '/default/ {print $5; exit}')
 IP=$(ip -4 addr show "$IFACE" | awk '/inet / {print $2}' | cut -d/ -f1 | head -n 1)

tools/addon/filebrowser.sh

@@ -5,8 +5,8 @@
 # License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
 
 function header_info {
-    clear
-    cat <<"EOF"
+  clear
+  cat <<"EOF"
     _______ __     ____
    / ____(_) /__  / __ )_________ _      __________  _____
   / /_  / / / _ \/ __  / ___/ __ \ | /| / / ___/ _ \/ ___/
@@ -29,6 +29,10 @@ INSTALL_PATH="/usr/local/bin/filebrowser"
 DB_PATH="/usr/local/community-scripts/filebrowser.db"
 DEFAULT_PORT=8080
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "filebrowser" "addon"
+
 # Get first non-loopback IP & Detect primary network interface dynamically
 IFACE=$(ip -4 route | awk '/default/ {print $5; exit}')
 IP=$(ip -4 addr show "$IFACE" | awk '/inet / {print $2}' | cut -d/ -f1 | head -n 1)
@@ -38,65 +42,65 @@ IP=$(ip -4 addr show "$IFACE" | awk '/inet / {print $2}' | cut -d/ -f1 | head -n
 
 # Detect OS
 if [[ -f "/etc/alpine-release" ]]; then
-    OS="Alpine"
-    SERVICE_PATH="/etc/init.d/filebrowser"
-    PKG_MANAGER="apk add --no-cache"
+  OS="Alpine"
+  SERVICE_PATH="/etc/init.d/filebrowser"
+  PKG_MANAGER="apk add --no-cache"
 elif [[ -f "/etc/debian_version" ]]; then
-    OS="Debian"
-    SERVICE_PATH="/etc/systemd/system/filebrowser.service"
-    PKG_MANAGER="apt-get install -y"
+  OS="Debian"
+  SERVICE_PATH="/etc/systemd/system/filebrowser.service"
+  PKG_MANAGER="apt-get install -y"
 else
-    echo -e "${CROSS} Unsupported OS detected. Exiting."
-    exit 1
+  echo -e "${CROSS} Unsupported OS detected. Exiting."
+  exit 1
 fi
 
 header_info
 
 function msg_info() {
-    local msg="$1"
-    echo -e "${INFO} ${YW}${msg}...${CL}"
+  local msg="$1"
+  echo -e "${INFO} ${YW}${msg}...${CL}"
 }
 
 function msg_ok() {
-    local msg="$1"
-    echo -e "${CM} ${GN}${msg}${CL}"
+  local msg="$1"
+  echo -e "${CM} ${GN}${msg}${CL}"
 }
 
 function msg_error() {
-    local msg="$1"
-    echo -e "${CROSS} ${RD}${msg}${CL}"
+  local msg="$1"
+  echo -e "${CROSS} ${RD}${msg}${CL}"
 }
 
 if [ -f "$INSTALL_PATH" ]; then
-    echo -e "${YW}⚠️ ${APP} is already installed.${CL}"
-    read -r -p "Would you like to uninstall ${APP}? (y/N): " uninstall_prompt
-    if [[ "${uninstall_prompt,,}" =~ ^(y|yes)$ ]]; then
-        msg_info "Uninstalling ${APP}"
-        if [[ "$OS" == "Debian" ]]; then
-            systemctl disable --now filebrowser.service &>/dev/null
-            rm -f "$SERVICE_PATH"
-        else
-            rc-service filebrowser stop &>/dev/null
-            rc-update del filebrowser &>/dev/null
-            rm -f "$SERVICE_PATH"
-        fi
-        rm -f "$INSTALL_PATH" "$DB_PATH"
-        msg_ok "${APP} has been uninstalled."
-        exit 0
-    fi
-
-    read -r -p "Would you like to update ${APP}? (y/N): " update_prompt
-    if [[ "${update_prompt,,}" =~ ^(y|yes)$ ]]; then
-        msg_info "Updating ${APP}"
-        if ! command -v curl &>/dev/null; then $PKG_MANAGER curl &>/dev/null; fi
-        curl -fsSL "https://github.com/filebrowser/filebrowser/releases/latest/download/linux-amd64-filebrowser.tar.gz" | tar -xzv -C /usr/local/bin &>/dev/null
-        chmod +x "$INSTALL_PATH"
-        msg_ok "Updated ${APP}"
-        exit 0
+  echo -e "${YW}⚠️ ${APP} is already installed.${CL}"
+  read -r -p "Would you like to uninstall ${APP}? (y/N): " uninstall_prompt
+  if [[ "${uninstall_prompt,,}" =~ ^(y|yes)$ ]]; then
+    msg_info "Uninstalling ${APP}"
+    if [[ "$OS" == "Debian" ]]; then
+      systemctl disable --now filebrowser.service &>/dev/null
+      rm -f "$SERVICE_PATH"
     else
-        echo -e "${YW}⚠️ Update skipped. Exiting.${CL}"
-        exit 0
+      rc-service filebrowser stop &>/dev/null
+      rc-update del filebrowser &>/dev/null
+      rm -f "$SERVICE_PATH"
     fi
+    rm -f "$INSTALL_PATH" "$DB_PATH"
+    msg_ok "${APP} has been uninstalled."
+    exit 0
+  fi
+
+  read -r -p "Would you like to update ${APP}? (y/N): " update_prompt
+  if [[ "${update_prompt,,}" =~ ^(y|yes)$ ]]; then
+    msg_info "Updating ${APP}"
+    if ! command -v curl &>/dev/null; then $PKG_MANAGER curl &>/dev/null; fi
+    curl -fsSL "https://github.com/filebrowser/filebrowser/releases/latest/download/linux-amd64-filebrowser.tar.gz" | tar -xzv -C /usr/local/bin &>/dev/null
+    chmod +x "$INSTALL_PATH"
+    msg_ok "Updated ${APP}"
+    exit 0
+  else
+    echo -e "${YW}⚠️ Update skipped. Exiting.${CL}"
+    exit 0
+  fi
 fi
 
 echo -e "${YW}⚠️ ${APP} is not installed.${CL}"
@@ -105,43 +109,43 @@ PORT=${PORT:-$DEFAULT_PORT}
 
 read -r -p "Would you like to install ${APP}? (y/n): " install_prompt
 if [[ "${install_prompt,,}" =~ ^(y|yes)$ ]]; then
-    msg_info "Installing ${APP} on ${OS}"
-    $PKG_MANAGER wget tar curl &>/dev/null
-    curl -fsSL "https://github.com/filebrowser/filebrowser/releases/latest/download/linux-amd64-filebrowser.tar.gz" | tar -xzv -C /usr/local/bin &>/dev/null
-    chmod +x "$INSTALL_PATH"
-    msg_ok "Installed ${APP}"
+  msg_info "Installing ${APP} on ${OS}"
+  $PKG_MANAGER wget tar curl &>/dev/null
+  curl -fsSL "https://github.com/filebrowser/filebrowser/releases/latest/download/linux-amd64-filebrowser.tar.gz" | tar -xzv -C /usr/local/bin &>/dev/null
+  chmod +x "$INSTALL_PATH"
+  msg_ok "Installed ${APP}"
 
-    msg_info "Creating FileBrowser directory"
-    mkdir -p /usr/local/community-scripts
-    chown root:root /usr/local/community-scripts
-    chmod 755 /usr/local/community-scripts
-    touch "$DB_PATH"
-    chown root:root "$DB_PATH"
-    chmod 644 "$DB_PATH"
-    msg_ok "Directory created successfully"
+  msg_info "Creating FileBrowser directory"
+  mkdir -p /usr/local/community-scripts
+  chown root:root /usr/local/community-scripts
+  chmod 755 /usr/local/community-scripts
+  touch "$DB_PATH"
+  chown root:root "$DB_PATH"
+  chmod 644 "$DB_PATH"
+  msg_ok "Directory created successfully"
 
-    read -r -p "Would you like to use No Authentication? (y/N): " auth_prompt
-    if [[ "${auth_prompt,,}" =~ ^(y|yes)$ ]]; then
-        msg_info "Configuring No Authentication"
-        cd /usr/local/community-scripts
-        filebrowser config init -a '0.0.0.0' -p "$PORT" -d "$DB_PATH" &>/dev/null
-        filebrowser config set -a '0.0.0.0' -p "$PORT" -d "$DB_PATH" &>/dev/null
-        filebrowser config init --auth.method=noauth &>/dev/null
-        filebrowser config set --auth.method=noauth &>/dev/null
-        filebrowser users add ID 1 --perm.admin &>/dev/null
-        msg_ok "No Authentication configured"
-    else
-        msg_info "Setting up default authentication"
-        cd /usr/local/community-scripts
-        filebrowser config init -a '0.0.0.0' -p "$PORT" -d "$DB_PATH" &>/dev/null
-        filebrowser config set -a '0.0.0.0' -p "$PORT" -d "$DB_PATH" &>/dev/null
-        filebrowser users add admin helper-scripts.com --perm.admin --database "$DB_PATH" &>/dev/null
-        msg_ok "Default authentication configured (admin:helper-scripts.com)"
-    fi
+  read -r -p "Would you like to use No Authentication? (y/N): " auth_prompt
+  if [[ "${auth_prompt,,}" =~ ^(y|yes)$ ]]; then
+    msg_info "Configuring No Authentication"
+    cd /usr/local/community-scripts
+    filebrowser config init -a '0.0.0.0' -p "$PORT" -d "$DB_PATH" &>/dev/null
+    filebrowser config set -a '0.0.0.0' -p "$PORT" -d "$DB_PATH" &>/dev/null
+    filebrowser config init --auth.method=noauth &>/dev/null
+    filebrowser config set --auth.method=noauth &>/dev/null
+    filebrowser users add ID 1 --perm.admin &>/dev/null
+    msg_ok "No Authentication configured"
+  else
+    msg_info "Setting up default authentication"
+    cd /usr/local/community-scripts
+    filebrowser config init -a '0.0.0.0' -p "$PORT" -d "$DB_PATH" &>/dev/null
+    filebrowser config set -a '0.0.0.0' -p "$PORT" -d "$DB_PATH" &>/dev/null
+    filebrowser users add admin helper-scripts.com --perm.admin --database "$DB_PATH" &>/dev/null
+    msg_ok "Default authentication configured (admin:helper-scripts.com)"
+  fi
 
-    msg_info "Creating service"
-    if [[ "$OS" == "Debian" ]]; then
-        cat <<EOF >"$SERVICE_PATH"
+  msg_info "Creating service"
+  if [[ "$OS" == "Debian" ]]; then
+    cat <<EOF >"$SERVICE_PATH"
 [Unit]
 Description=Filebrowser
 After=network-online.target
@@ -157,9 +161,9 @@ Restart=always
 [Install]
 WantedBy=multi-user.target
 EOF
-        systemctl enable -q --now filebrowser
-    else
-        cat <<EOF >"$SERVICE_PATH"
+    systemctl enable -q --now filebrowser
+  else
+    cat <<EOF >"$SERVICE_PATH"
 #!/sbin/openrc-run
 
 command="/usr/local/bin/filebrowser"
@@ -172,14 +176,14 @@ depend() {
     need net
 }
 EOF
-        chmod +x "$SERVICE_PATH"
-        rc-update add filebrowser default &>/dev/null
-        rc-service filebrowser start &>/dev/null
-    fi
-    msg_ok "Service created successfully"
+    chmod +x "$SERVICE_PATH"
+    rc-update add filebrowser default &>/dev/null
+    rc-service filebrowser start &>/dev/null
+  fi
+  msg_ok "Service created successfully"
 
-    echo -e "${CM} ${GN}${APP} is reachable at: ${BL}http://$IP:$PORT${CL}"
+  echo -e "${CM} ${GN}${APP} is reachable at: ${BL}http://$IP:$PORT${CL}"
 else
-    echo -e "${YW}⚠️ Installation skipped. Exiting.${CL}"
-    exit 0
+  echo -e "${YW}⚠️ Installation skipped. Exiting.${CL}"
+  exit 0
 fi

tools/addon/glances.sh

@@ -30,6 +30,10 @@ function msg_info() { echo -e "${INFO} ${YW}$1...${CL}"; }
 function msg_ok() { echo -e "${CM} ${GN}$1${CL}"; }
 function msg_error() { echo -e "${CROSS} ${RD}$1${CL}"; }
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "glances" "addon"
+
 get_lxc_ip() {
   if command -v hostname >/dev/null 2>&1 && hostname -I 2>/dev/null; then
     hostname -I | awk '{print $1}'

tools/addon/immich-public-proxy.sh

@@ -13,6 +13,7 @@ fi
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/core.func)
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/tools.func)
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/error_handler.func)
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
 
 # Enable error handling
 set -Eeuo pipefail
@@ -29,6 +30,7 @@ DEFAULT_PORT=3000
 
 # Initialize all core functions (colors, formatting, icons, STD mode)
 load_functions
+init_tool_telemetry "" "addon"
 
 # ==============================================================================
 # HEADER

tools/addon/jellystat.sh

@@ -13,6 +13,7 @@ fi
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/core.func)
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/tools.func)
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/error_handler.func)
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
 
 # Enable error handling
 set -Eeuo pipefail
@@ -29,6 +30,7 @@ DEFAULT_PORT=3000
 
 # Initialize all core functions (colors, formatting, icons, STD mode)
 load_functions
+init_tool_telemetry "" "addon"
 
 # ==============================================================================
 # HEADER

tools/addon/netdata.sh

@@ -26,6 +26,11 @@ BFR="\\r\\033[K"
 HOLD="-"
 CM="${GN}✓${CL}"
 silent() { "$@" >/dev/null 2>&1; }
+
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "netdata" "addon"
+
 set -e
 header_info
 echo "Loading..."

tools/addon/nextcloud-exporter.sh

@@ -13,11 +13,13 @@ fi
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/core.func)
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/tools.func)
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/error_handler.func)
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
 
 # Enable error handling
 set -Eeuo pipefail
 trap 'error_handler' ERR
 load_functions
+init_tool_telemetry "" "addon"
 
 # ==============================================================================
 # CONFIGURATION

tools/addon/olivetin.sh

@@ -27,6 +27,11 @@ HOLD="-"
 CM="${GN}✓${CL}"
 APP="OliveTin"
 hostname="$(hostname)"
+
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "olivetin" "addon"
+
 set-e
 header_info
 

tools/addon/phpmyadmin.sh

@@ -29,6 +29,10 @@ APP="phpMyAdmin"
 INSTALL_DIR_DEBIAN="/var/www/html/phpMyAdmin"
 INSTALL_DIR_ALPINE="/usr/share/phpmyadmin"
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "phpmyadmin" "addon"
+
 IFACE=$(ip -4 route | awk '/default/ {print $5; exit}')
 IP=$(ip -4 addr show "$IFACE" | awk '/inet / {print $2}' | cut -d/ -f1 | head -n 1)
 [[ -z "$IP" ]] && IP=$(hostname -I | awk '{print $1}')

tools/addon/pihole-exporter.sh

@@ -13,11 +13,13 @@ fi
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/core.func)
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/tools.func)
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/error_handler.func)
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
 
 # Enable error handling
 set -Eeuo pipefail
 trap 'error_handler' ERR
 load_functions
+init_tool_telemetry "" "addon"
 
 # ==============================================================================
 # CONFIGURATION

tools/addon/prometheus-paperless-ngx-exporter.sh

@@ -8,11 +8,13 @@
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/core.func)
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/tools.func)
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/error_handler.func)
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
 
 # Enable error handling
 set -Eeuo pipefail
 trap 'error_handler' ERR
 load_functions
+init_tool_telemetry "" "addon"
 
 # ==============================================================================
 # CONFIGURATION

tools/addon/pyenv.sh

@@ -28,6 +28,11 @@ function msg_error() {
   local msg="$1"
   echo -e "${BFR} ${CROSS} ${RD}${msg}${CL}"
 }
+
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "pyenv" "addon"
+
 if command -v pveversion >/dev/null 2>&1; then
   msg_error "Can't Install on Proxmox "
   exit

tools/addon/qbittorrent-exporter.sh

@@ -13,11 +13,13 @@ fi
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/core.func)
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/tools.func)
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/error_handler.func)
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
 
 # Enable error handling
 set -Eeuo pipefail
 trap 'error_handler' ERR
 load_functions
+init_tool_telemetry "" "addon"
 
 # ==============================================================================
 # CONFIGURATION

tools/addon/webmin.sh

@@ -36,6 +36,10 @@ msg_ok() {
   echo -e "${BFR} ${CM} ${GN}${msg}${CL}"
 }
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "webmin" "addon"
+
 header_info
 
 whiptail --backtitle "Proxmox VE Helper Scripts" --title "Webmin Installer" --yesno "This Will Install Webmin on this LXC Container. Proceed?" 10 58

tools/pve/add-iptag.sh

@@ -31,6 +31,10 @@ HOLD=" "
 CM="${GN}✓${CL} "
 CROSS="${RD}✗${CL} "
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "add-iptag" "pve"
+
 # Stop any running spinner
 stop_spinner() {
   if [ -n "$SPINNER_PID" ] && kill -0 "$SPINNER_PID" 2>/dev/null; then

tools/pve/clean-lxcs.sh

@@ -22,6 +22,10 @@ CM='\xE2\x9C\x94\033'
 GN="\033[1;92m"
 CL="\033[m"
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "clean-lxcs" "pve"
+
 header_info
 echo "Loading..."
 

tools/pve/clean-orphaned-lvm.sh

@@ -5,8 +5,8 @@
 # License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
 
 function header_info {
-    clear
-    cat <<"EOF"
+  clear
+  cat <<"EOF"
     ____                                          ________                    ____             __                         __   __ _    ____  ___    
    / __ \_________  _  ______ ___  ____  _  __   / ____/ /__  ____ _____     / __ \_________  / /_  ____ _____  ___  ____/ /  / /| |  / /  |/  /____
   / /_/ / ___/ __ \| |/_/ __ `__ \/ __ \| |/_/  / /   / / _ \/ __ `/ __ \   / / / / ___/ __ \/ __ \/ __ `/ __ \/ _ \/ __  /  / / | | / / /|_/ / ___/
@@ -16,62 +16,66 @@ function header_info {
 EOF
 }
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "clean-orphaned-lvm" "pve"
+
 # Function to check for orphaned LVM volumes
 function find_orphaned_lvm {
-    echo -e "\n🔍 Scanning for orphaned LVM volumes...\n"
+  echo -e "\n🔍 Scanning for orphaned LVM volumes...\n"
 
-    orphaned_volumes=()
-    while read -r lv vg size seg_type; do
-        # Exclude system-critical LVs and Ceph OSDs
-        if [[ "$lv" == "data" || "$lv" == "root" || "$lv" == "swap" || "$lv" =~ ^osd-block- ]]; then
-            continue
-        fi
+  orphaned_volumes=()
+  while read -r lv vg size seg_type; do
+    # Exclude system-critical LVs and Ceph OSDs
+    if [[ "$lv" == "data" || "$lv" == "root" || "$lv" == "swap" || "$lv" =~ ^osd-block- ]]; then
+      continue
+    fi
 
-        # Exclude thin pools (any name)
-        if [[ "$seg_type" == "thin-pool" ]]; then
-            continue
-        fi
+    # Exclude thin pools (any name)
+    if [[ "$seg_type" == "thin-pool" ]]; then
+      continue
+    fi
 
-        container_id=$(echo "$lv" | grep -oE "[0-9]+" | head -1)
-        # Check if the ID exists as a VM or LXC container
-        if [ -f "/etc/pve/lxc/${container_id}.conf" ] || [ -f "/etc/pve/qemu-server/${container_id}.conf" ]; then
-            continue
-        fi
+    container_id=$(echo "$lv" | grep -oE "[0-9]+" | head -1)
+    # Check if the ID exists as a VM or LXC container
+    if [ -f "/etc/pve/lxc/${container_id}.conf" ] || [ -f "/etc/pve/qemu-server/${container_id}.conf" ]; then
+      continue
+    fi
 
-        orphaned_volumes+=("$lv" "$vg" "$size")
-    done < <(lvs --noheadings -o lv_name,vg_name,lv_size,seg_type --separator ' ' 2>/dev/null | awk '{print $1, $2, $3, $4}')
+    orphaned_volumes+=("$lv" "$vg" "$size")
+  done < <(lvs --noheadings -o lv_name,vg_name,lv_size,seg_type --separator ' ' 2>/dev/null | awk '{print $1, $2, $3, $4}')
 
-    # Display orphaned volumes
-    echo -e "❗ The following orphaned LVM volumes were found:\n"
-    printf "%-25s %-10s %-10s\n" "LV Name" "VG" "Size"
-    printf "%-25s %-10s %-10s\n" "-------------------------" "----------" "----------"
+  # Display orphaned volumes
+  echo -e "❗ The following orphaned LVM volumes were found:\n"
+  printf "%-25s %-10s %-10s\n" "LV Name" "VG" "Size"
+  printf "%-25s %-10s %-10s\n" "-------------------------" "----------" "----------"
 
-    for ((i = 0; i < ${#orphaned_volumes[@]}; i += 3)); do
-        printf "%-25s %-10s %-10s\n" "${orphaned_volumes[i]}" "${orphaned_volumes[i + 1]}" "${orphaned_volumes[i + 2]}"
-    done
-    echo ""
+  for ((i = 0; i < ${#orphaned_volumes[@]}; i += 3)); do
+    printf "%-25s %-10s %-10s\n" "${orphaned_volumes[i]}" "${orphaned_volumes[i + 1]}" "${orphaned_volumes[i + 2]}"
+  done
+  echo ""
 }
 
 # Function to delete selected volumes
 function delete_orphaned_lvm {
-    for ((i = 0; i < ${#orphaned_volumes[@]}; i += 3)); do
-        lv="${orphaned_volumes[i]}"
-        vg="${orphaned_volumes[i + 1]}"
-        size="${orphaned_volumes[i + 2]}"
+  for ((i = 0; i < ${#orphaned_volumes[@]}; i += 3)); do
+    lv="${orphaned_volumes[i]}"
+    vg="${orphaned_volumes[i + 1]}"
+    size="${orphaned_volumes[i + 2]}"
 
-        read -p "❓ Do you want to delete $lv (VG: $vg, Size: $size)? [y/N]: " confirm
-        if [[ "$confirm" =~ ^[Yy]$ ]]; then
-            echo -e "🗑️  Deleting $lv from $vg..."
-            lvremove -f "$vg/$lv"
-            if [ $? -eq 0 ]; then
-                echo -e "✅ Successfully deleted $lv.\n"
-            else
-                echo -e "❌ Failed to delete $lv.\n"
-            fi
-        else
-            echo -e "⚠️  Skipping $lv.\n"
-        fi
-    done
+    read -p "❓ Do you want to delete $lv (VG: $vg, Size: $size)? [y/N]: " confirm
+    if [[ "$confirm" =~ ^[Yy]$ ]]; then
+      echo -e "🗑️  Deleting $lv from $vg..."
+      lvremove -f "$vg/$lv"
+      if [ $? -eq 0 ]; then
+        echo -e "✅ Successfully deleted $lv.\n"
+      else
+        echo -e "❌ Failed to delete $lv.\n"
+      fi
+    else
+      echo -e "⚠️  Skipping $lv.\n"
+    fi
+  done
 }
 
 # Run script

tools/pve/container-restore-from-backup.sh

@@ -7,8 +7,8 @@
 
 clear
 if command -v pveversion >/dev/null 2>&1; then
-    echo -e "⚠️  Can't Run from the Proxmox Shell"
-    exit
+  echo -e "⚠️  Can't Run from the Proxmox Shell"
+  exit
 fi
 YW=$(echo "\033[33m")
 BL=$(echo "\033[36m")
@@ -23,16 +23,16 @@ CM="${GN}✓${CL}"
 CROSS="${RD}✗${CL}"
 APP="Home Assistant Container"
 while true; do
-    read -p "This will restore ${APP} from a backup. Proceed(y/n)?" yn
-    case $yn in
-    [Yy]*) break ;;
-    [Nn]*) exit ;;
-    *) echo "Please answer yes or no." ;;
-    esac
+  read -p "This will restore ${APP} from a backup. Proceed(y/n)?" yn
+  case $yn in
+  [Yy]*) break ;;
+  [Nn]*) exit ;;
+  *) echo "Please answer yes or no." ;;
+  esac
 done
 clear
 function header_info {
-    cat <<"EOF"
+  cat <<"EOF"
     __  __                        ___              _      __              __              
    / / / /___  ____ ___  ___     /   |  __________(_)____/ /_____ _____  / /_   
   / /_/ / __ \/ __ `__ \/ _ \   / /| | / ___/ ___/ / ___/ __/ __ `/ __ \/ __/  
@@ -44,35 +44,39 @@ EOF
 
 header_info
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "container-restore" "pve"
+
 function msg_info() {
-    local msg="$1"
-    echo -ne " ${HOLD} ${YW}${msg}..."
+  local msg="$1"
+  echo -ne " ${HOLD} ${YW}${msg}..."
 }
 function msg_ok() {
-    local msg="$1"
-    echo -e "${BFR} ${CM} ${GN}${msg}${CL}"
+  local msg="$1"
+  echo -e "${BFR} ${CM} ${GN}${msg}${CL}"
 }
 function msg_error() {
-    local msg="$1"
-    echo -e "${BFR} ${CROSS} ${RD}${msg}${CL}"
+  local msg="$1"
+  echo -e "${BFR} ${CROSS} ${RD}${msg}${CL}"
 }
 if [ -z "$(ls -A /var/lib/docker/volumes/hass_config/_data/backups/)" ]; then
-    msg_error "No backups found! \n"
-    exit 1
+  msg_error "No backups found! \n"
+  exit 1
 fi
 DIR=/var/lib/docker/volumes/hass_config/_data/restore
 if [ -d "$DIR" ]; then
-    msg_ok "Restore Directory Exists."
+  msg_ok "Restore Directory Exists."
 else
-    mkdir -p /var/lib/docker/volumes/hass_config/_data/restore
-    msg_ok "Created Restore Directory."
+  mkdir -p /var/lib/docker/volumes/hass_config/_data/restore
+  msg_ok "Created Restore Directory."
 fi
 cd /var/lib/docker/volumes/hass_config/_data/backups/
 PS3="Please enter your choice: "
 files="$(ls -A .)"
 select filename in ${files}; do
-    msg_ok "You selected ${BL}${filename}${CL}"
-    break
+  msg_ok "You selected ${BL}${filename}${CL}"
+  break
 done
 msg_info "Stopping Home Assistant"
 docker stop homeassistant &>/dev/null

tools/pve/core-restore-from-backup.sh

@@ -7,8 +7,8 @@
 
 clear
 if command -v pveversion >/dev/null 2>&1; then
-    echo -e "⚠️  Can't Run from the Proxmox Shell"
-    exit
+  echo -e "⚠️  Can't Run from the Proxmox Shell"
+  exit
 fi
 YW=$(echo "\033[33m")
 BL=$(echo "\033[36m")
@@ -23,16 +23,16 @@ CM="${GN}✓${CL}"
 CROSS="${RD}✗${CL}"
 APP="Home Assistant Core"
 while true; do
-    read -p "This will restore ${APP} from a backup. Proceed(y/n)?" yn
-    case $yn in
-    [Yy]*) break ;;
-    [Nn]*) exit ;;
-    *) echo "Please answer yes or no." ;;
-    esac
+  read -p "This will restore ${APP} from a backup. Proceed(y/n)?" yn
+  case $yn in
+  [Yy]*) break ;;
+  [Nn]*) exit ;;
+  *) echo "Please answer yes or no." ;;
+  esac
 done
 clear
 function header_info {
-    cat <<"EOF"
+  cat <<"EOF"
     __  __                        ___              _      __              __     ______              
    / / / /___  ____ ___  ___     /   |  __________(_)____/ /_____ _____  / /_   / ____/___  ________ 
   / /_/ / __ \/ __ `__ \/ _ \   / /| | / ___/ ___/ / ___/ __/ __ `/ __ \/ __/  / /   / __ \/ ___/ _ \
@@ -44,35 +44,39 @@ EOF
 
 header_info
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "core-restore" "pve"
+
 function msg_info() {
-    local msg="$1"
-    echo -ne " ${HOLD} ${YW}${msg}..."
+  local msg="$1"
+  echo -ne " ${HOLD} ${YW}${msg}..."
 }
 function msg_ok() {
-    local msg="$1"
-    echo -e "${BFR} ${CM} ${GN}${msg}${CL}"
+  local msg="$1"
+  echo -e "${BFR} ${CM} ${GN}${msg}${CL}"
 }
 function msg_error() {
-    local msg="$1"
-    echo -e "${BFR} ${CROSS} ${RD}${msg}${CL}"
+  local msg="$1"
+  echo -e "${BFR} ${CROSS} ${RD}${msg}${CL}"
 }
 if [ -z "$(ls -A /root/.homeassistant/backups/)" ]; then
-    msg_error "No backups found! \n"
-    exit 1
+  msg_error "No backups found! \n"
+  exit 1
 fi
 DIR=/root/.homeassistant/restore
 if [ -d "$DIR" ]; then
-    msg_ok "Restore Directory Exists."
+  msg_ok "Restore Directory Exists."
 else
-    mkdir -p /root/.homeassistant/restore
-    msg_ok "Created Restore Directory."
+  mkdir -p /root/.homeassistant/restore
+  msg_ok "Created Restore Directory."
 fi
 cd /root/.homeassistant/backups/
 PS3="Please enter your choice: "
 files="$(ls -A .)"
 select filename in ${files}; do
-    msg_ok "You selected ${BL}${filename}${CL}"
-    break
+  msg_ok "You selected ${BL}${filename}${CL}"
+  break
 done
 msg_info "Stopping Home Assistant"
 sudo service homeassistant stop

tools/pve/execute.sh

@@ -22,6 +22,11 @@ RD=$(echo "\033[01;31m")
 CM='\xE2\x9C\x94\033'
 GN=$(echo "\033[1;92m")
 CL=$(echo "\033[m")
+
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "execute-lxcs" "pve"
+
 header_info
 echo "Loading..."
 whiptail --backtitle "Proxmox VE Helper Scripts" --title "Proxmox VE LXC Execute" --yesno "This will execute a command inside selected LXC Containers. Proceed?" 10 58
@@ -40,7 +45,6 @@ if [ $? -ne 0 ]; then
   exit
 fi
 
-
 read -r -p "Enter here command for inside the containers: " custom_command
 
 header_info
@@ -50,12 +54,11 @@ function execute_in() {
   container=$1
   name=$(pct exec "$container" hostname)
   echo -e "${BL}[Info]${GN} Execute inside${BL} ${name}${GN} with output: ${CL}"
-    if !   pct exec "$container" -- bash -c "command ${custom_command} >/dev/null 2>&1"
-      then
-        echo -e "${BL}[Info]${GN} Skipping ${name} ${RD}$container has no command: ${custom_command}"
-      else
-        pct exec "$container" -- bash -c "${custom_command}" | tee
-    fi
+  if ! pct exec "$container" -- bash -c "command ${custom_command} >/dev/null 2>&1"; then
+    echo -e "${BL}[Info]${GN} Skipping ${name} ${RD}$container has no command: ${custom_command}"
+  else
+    pct exec "$container" -- bash -c "${custom_command}" | tee
+  fi
 }
 
 for container in $(pct list | awk '{if(NR>1) print $1}'); do

tools/pve/frigate-support.sh

@@ -15,6 +15,11 @@ function header_info {
           /___/                       /_/  /_/
 EOF
 }
+
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "frigate-support" "pve"
+
 header_info
 while true; do
   read -p "This will Prepare a LXC Container for Frigate. Proceed (y/n)?" yn

tools/pve/fstrim.sh

@@ -19,6 +19,10 @@ RD="\033[01;31m"
 GN="\033[1;92m"
 CL="\033[m"
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "fstrim" "pve"
+
 LOGFILE="/var/log/fstrim.log"
 touch "$LOGFILE"
 chmod 600 "$LOGFILE"

tools/pve/host-backup.sh

@@ -16,6 +16,10 @@ function header_info {
 EOF
 }
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "host-backup" "pve"
+
 # Function to perform backup
 function perform_backup {
   local BACKUP_PATH

tools/pve/hw-acceleration.sh

@@ -29,6 +29,11 @@ BFR="\\r\\033[K"
 HOLD="-"
 CM="${GN}✓${CL}"
 set -e
+
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "hw-acceleration" "pve"
+
 header_info
 echo "Loading..."
 function msg_info() {

tools/pve/kernel-clean.sh

@@ -22,6 +22,10 @@ GN="\033[1;92m"
 RD="\033[01;31m"
 CL="\033[m"
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "kernel-clean" "pve"
+
 # Detect current kernel
 current_kernel=$(uname -r)
 available_kernels=$(dpkg --list | grep 'kernel-.*-pve' | awk '{print $2}' | grep -v "$current_kernel" | sort -V)

tools/pve/kernel-pin.sh

@@ -25,6 +25,11 @@ HOLD="-"
 CM="${GN}✓${CL}"
 current_kernel=$(uname -r)
 available_kernels=$(dpkg --list | grep 'kernel-.*-pve' | awk '{print substr($2, 16, length($2)-22)}')
+
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "kernel-pin" "pve"
+
 header_info
 
 function msg_info() {

tools/pve/lxc-delete.sh

@@ -38,6 +38,10 @@ CL=$(echo "\033[m")
 TAB="  "
 CM="${TAB}✔️${TAB}${CL}"
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "lxc-delete" "pve"
+
 header_info
 echo "Loading..."
 whiptail --backtitle "Proxmox VE Helper Scripts" --title "Proxmox VE LXC Deletion" --yesno "This will delete LXC containers. Proceed?" 10 58

tools/pve/microcode.sh

@@ -29,6 +29,10 @@ msg_info() { echo -ne " ${HOLD} ${YW}$1..."; }
 msg_ok() { echo -e "${BFR} ${CM} ${GN}$1${CL}"; }
 msg_error() { echo -e "${BFR} ${CROSS} ${RD}$1${CL}"; }
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "microcode" "pve"
+
 header_info
 current_microcode=$(journalctl -k | grep -i 'microcode: Current revision:' | grep -oP 'Current revision: \K0x[0-9a-f]+')
 [ -z "$current_microcode" ] && current_microcode="Not found."

tools/pve/monitor-all.sh

@@ -15,6 +15,10 @@ cat <<"EOF"
 
 EOF
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "monitor-all" "pve"
+
 add() {
   echo -e "\n IMPORTANT: Tag-Based Monitoring Enabled"
   echo "Only VMs and containers with the tag 'mon-restart' will be automatically restarted by this service."
@@ -28,9 +32,9 @@ add() {
   while true; do
     read -p "This script will add Monitor All to Proxmox VE. Proceed (y/n)? " yn
     case $yn in
-      [Yy]*) break ;;
-      [Nn]*) exit ;;
-      *) echo "Please answer yes or no." ;;
+    [Yy]*) break ;;
+    [Nn]*) exit ;;
+    *) echo "Please answer yes or no." ;;
     esac
   done
 
@@ -175,5 +179,8 @@ CHOICE=$(whiptail --backtitle "Proxmox VE Helper Scripts" --title "Monitor-All f
 case $CHOICE in
 "Add") add ;;
 "Remove") remove ;;
-*) echo "Exiting..."; exit 0 ;;
+*)
+  echo "Exiting..."
+  exit 0
+  ;;
 esac

tools/pve/nic-offloading-fix.sh

@@ -19,8 +19,8 @@ INFO="${TAB}ℹ️${TAB}${CL}"
 WARN="${TAB}⚠️${TAB}${CL}"
 
 function header_info {
-clear
-cat <<"EOF"
+  clear
+  cat <<"EOF"
 
     _   ____________   ____  __________                ___                ____  _            __    __
    / | / /  _/ ____/  / __ \/ __/ __/ /___  ____ _____/ (_)___  ____ _   / __ \(_)________ _/ /_  / /__  _____
@@ -33,6 +33,10 @@ Enhanced version supporting both e1000e and e1000 drivers
 EOF
 }
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "nic-offloading-fix" "pve"
+
 header_info
 
 function msg_info() { echo -e "${INFO} ${YW}${1}...${CL}"; }
@@ -42,15 +46,18 @@ function msg_warn() { echo -e "${WARN} ${YWB}${1}"; }
 
 # Check for root privileges
 if [ "$(id -u)" -ne 0 ]; then
-    msg_error "Error: This script must be run as root."
-    exit 1
+  msg_error "Error: This script must be run as root."
+  exit 1
 fi
 
 if ! command -v ethtool >/dev/null 2>&1; then
-    msg_info "Installing ethtool"
-    apt-get update &>/dev/null
-    apt-get install -y ethtool &>/dev/null || { msg_error "Failed to install ethtool. Exiting."; exit 1; }
-    msg_ok "ethtool installed successfully"
+  msg_info "Installing ethtool"
+  apt-get update &>/dev/null
+  apt-get install -y ethtool &>/dev/null || {
+    msg_error "Failed to install ethtool. Exiting."
+    exit 1
+  }
+  msg_ok "ethtool installed successfully"
 fi
 
 # Get list of network interfaces using Intel e1000e or e1000 drivers
@@ -60,95 +67,95 @@ COUNT=0
 msg_info "Searching for Intel e1000e and e1000 interfaces"
 
 for device in /sys/class/net/*; do
-    interface="$(basename "$device")"  # or adjust the rest of the usages below, as mostly you'll use the path anyway
-    # Skip loopback interface and virtual interfaces
-    if [[ "$interface" != "lo" ]] && [[ ! "$interface" =~ ^(tap|fwbr|veth|vmbr|bonding_masters) ]]; then
-        # Check if the interface uses the e1000e or e1000 driver
-        driver=$(basename $(readlink -f /sys/class/net/$interface/device/driver 2>/dev/null) 2>/dev/null)
-        
-        if [[ "$driver" == "e1000e" ]] || [[ "$driver" == "e1000" ]]; then
-            # Get MAC address for additional identification
-            mac=$(cat /sys/class/net/$interface/address 2>/dev/null)
-            INTERFACES+=("$interface" "Intel $driver NIC ($mac)")
-            ((COUNT++))
-        fi
+  interface="$(basename "$device")" # or adjust the rest of the usages below, as mostly you'll use the path anyway
+  # Skip loopback interface and virtual interfaces
+  if [[ "$interface" != "lo" ]] && [[ ! "$interface" =~ ^(tap|fwbr|veth|vmbr|bonding_masters) ]]; then
+    # Check if the interface uses the e1000e or e1000 driver
+    driver=$(basename $(readlink -f /sys/class/net/$interface/device/driver 2>/dev/null) 2>/dev/null)
+
+    if [[ "$driver" == "e1000e" ]] || [[ "$driver" == "e1000" ]]; then
+      # Get MAC address for additional identification
+      mac=$(cat /sys/class/net/$interface/address 2>/dev/null)
+      INTERFACES+=("$interface" "Intel $driver NIC ($mac)")
+      ((COUNT++))
     fi
+  fi
 done
 
 # Check if any Intel e1000e/e1000 interfaces were found
 if [ ${#INTERFACES[@]} -eq 0 ]; then
-    whiptail --title "Error" --msgbox "No Intel e1000e or e1000 network interfaces found!" 10 60
-    msg_error "No Intel e1000e or e1000 network interfaces found! Exiting."
-    exit 1
+  whiptail --title "Error" --msgbox "No Intel e1000e or e1000 network interfaces found!" 10 60
+  msg_error "No Intel e1000e or e1000 network interfaces found! Exiting."
+  exit 1
 fi
 
 msg_ok "Found ${BL}$COUNT${GN} Intel e1000e/e1000 interfaces"
 
 # Create a checklist for interface selection with all interfaces initially checked
 INTERFACES_CHECKLIST=()
-for ((i=0; i<${#INTERFACES[@]}; i+=2)); do
-    INTERFACES_CHECKLIST+=("${INTERFACES[i]}" "${INTERFACES[i+1]}" "ON")
+for ((i = 0; i < ${#INTERFACES[@]}; i += 2)); do
+  INTERFACES_CHECKLIST+=("${INTERFACES[i]}" "${INTERFACES[i + 1]}" "ON")
 done
 
 # Show interface selection checklist
 SELECTED_INTERFACES=$(whiptail --backtitle "Intel e1000e/e1000 NIC Offloading Disabler" --title "Network Interfaces" \
-    --separate-output --checklist "Select Intel e1000e/e1000 network interfaces\n(Space to toggle, Enter to confirm):" 15 80 6 \
-    "${INTERFACES_CHECKLIST[@]}" 3>&1 1>&2 2>&3)
+  --separate-output --checklist "Select Intel e1000e/e1000 network interfaces\n(Space to toggle, Enter to confirm):" 15 80 6 \
+  "${INTERFACES_CHECKLIST[@]}" 3>&1 1>&2 2>&3)
 
 exitstatus=$?
 if [ $exitstatus != 0 ]; then
-    msg_info "User canceled. Exiting."
-    exit 0
+  msg_info "User canceled. Exiting."
+  exit 0
 fi
 
 # Check if any interfaces were selected
 if [ -z "$SELECTED_INTERFACES" ]; then
-    msg_error "No interfaces selected. Exiting."
-    exit 0
+  msg_error "No interfaces selected. Exiting."
+  exit 0
 fi
 
 # Convert the selected interfaces into an array
-readarray -t INTERFACE_ARRAY <<< "$SELECTED_INTERFACES"
+readarray -t INTERFACE_ARRAY <<<"$SELECTED_INTERFACES"
 
 # Show the number of selected interfaces
 INTERFACE_COUNT=${#INTERFACE_ARRAY[@]}
 
 # Print selected interfaces with their driver types
 for iface in "${INTERFACE_ARRAY[@]}"; do
-    driver=$(basename $(readlink -f /sys/class/net/$iface/device/driver 2>/dev/null) 2>/dev/null)
-    msg_ok "Selected interface: ${BL}$iface${GN} (${BL}$driver${GN})"
+  driver=$(basename $(readlink -f /sys/class/net/$iface/device/driver 2>/dev/null) 2>/dev/null)
+  msg_ok "Selected interface: ${BL}$iface${GN} (${BL}$driver${GN})"
 done
 
 # Ask for confirmation with the list of selected interfaces
 CONFIRMATION_MSG="You have selected the following interface(s):\n\n"
 for iface in "${INTERFACE_ARRAY[@]}"; do
-    SPEED=$(cat /sys/class/net/$iface/speed 2>/dev/null || echo "Unknown")
-    MAC=$(cat /sys/class/net/$iface/address 2>/dev/null)
-    DRIVER=$(basename $(readlink -f /sys/class/net/$iface/device/driver 2>/dev/null) 2>/dev/null)
-    CONFIRMATION_MSG+="- $iface (Driver: $DRIVER, MAC: $MAC, Speed: ${SPEED}Mbps)\n"
+  SPEED=$(cat /sys/class/net/$iface/speed 2>/dev/null || echo "Unknown")
+  MAC=$(cat /sys/class/net/$iface/address 2>/dev/null)
+  DRIVER=$(basename $(readlink -f /sys/class/net/$iface/device/driver 2>/dev/null) 2>/dev/null)
+  CONFIRMATION_MSG+="- $iface (Driver: $DRIVER, MAC: $MAC, Speed: ${SPEED}Mbps)\n"
 done
 CONFIRMATION_MSG+="\nThis will create systemd service(s) to disable offloading features.\n\nProceed?"
 
 if ! whiptail --backtitle "Intel e1000e/e1000 NIC Offloading Disabler" --title "Confirmation" \
-    --yesno "$CONFIRMATION_MSG" 20 80; then
-    msg_info "User canceled. Exiting."
-    exit 0
+  --yesno "$CONFIRMATION_MSG" 20 80; then
+  msg_info "User canceled. Exiting."
+  exit 0
 fi
 
 # Loop through all selected interfaces and create services for each
 for SELECTED_INTERFACE in "${INTERFACE_ARRAY[@]}"; do
-    # Get the driver type for this specific interface
-    DRIVER=$(basename $(readlink -f /sys/class/net/$SELECTED_INTERFACE/device/driver 2>/dev/null) 2>/dev/null)
-    
-    # Create service name for this interface
-    SERVICE_NAME="disable-nic-offload-$SELECTED_INTERFACE.service"
-    SERVICE_PATH="/etc/systemd/system/$SERVICE_NAME"
-    
-    # Create the service file with driver-specific optimizations
-    msg_info "Creating systemd service for interface: ${BL}$SELECTED_INTERFACE${YW} (${BL}$DRIVER${YW})"
-    
-    # Start with the common part of the service file
-    cat > "$SERVICE_PATH" << EOF
+  # Get the driver type for this specific interface
+  DRIVER=$(basename $(readlink -f /sys/class/net/$SELECTED_INTERFACE/device/driver 2>/dev/null) 2>/dev/null)
+
+  # Create service name for this interface
+  SERVICE_NAME="disable-nic-offload-$SELECTED_INTERFACE.service"
+  SERVICE_PATH="/etc/systemd/system/$SERVICE_NAME"
+
+  # Create the service file with driver-specific optimizations
+  msg_info "Creating systemd service for interface: ${BL}$SELECTED_INTERFACE${YW} (${BL}$DRIVER${YW})"
+
+  # Start with the common part of the service file
+  cat >"$SERVICE_PATH" <<EOF
 [Unit]
 Description=Disable NIC offloading for Intel $DRIVER interface $SELECTED_INTERFACE
 After=network.target
@@ -163,45 +170,49 @@ RemainAfterExit=true
 WantedBy=multi-user.target
 EOF
 
-    # Check if service file was created successfully
-    if [ ! -f "$SERVICE_PATH" ]; then
-        whiptail --title "Error" --msgbox "Failed to create service file for $SELECTED_INTERFACE!" 10 50
-        msg_error "Failed to create service file for $SELECTED_INTERFACE! Skipping to next interface."
-        continue
-    fi
+  # Check if service file was created successfully
+  if [ ! -f "$SERVICE_PATH" ]; then
+    whiptail --title "Error" --msgbox "Failed to create service file for $SELECTED_INTERFACE!" 10 50
+    msg_error "Failed to create service file for $SELECTED_INTERFACE! Skipping to next interface."
+    continue
+  fi
 
-    # Configure this service
-    {
-        echo "25"; sleep 0.2
-        # Reload systemd to recognize the new service
-        systemctl daemon-reload
-        echo "50"; sleep 0.2
-        # Start the service
-        systemctl start "$SERVICE_NAME"
-        echo "75"; sleep 0.2
-        # Enable the service to start on boot
-        systemctl enable "$SERVICE_NAME"
-        echo "100"; sleep 0.2
-    } | whiptail --backtitle "Intel e1000e/e1000 NIC Offloading Disabler" --gauge "Configuring service for $SELECTED_INTERFACE..." 10 80 0
+  # Configure this service
+  {
+    echo "25"
+    sleep 0.2
+    # Reload systemd to recognize the new service
+    systemctl daemon-reload
+    echo "50"
+    sleep 0.2
+    # Start the service
+    systemctl start "$SERVICE_NAME"
+    echo "75"
+    sleep 0.2
+    # Enable the service to start on boot
+    systemctl enable "$SERVICE_NAME"
+    echo "100"
+    sleep 0.2
+  } | whiptail --backtitle "Intel e1000e/e1000 NIC Offloading Disabler" --gauge "Configuring service for $SELECTED_INTERFACE..." 10 80 0
 
-    # Individual service status
-    if systemctl is-active --quiet "$SERVICE_NAME"; then
-        SERVICE_STATUS="Active"
-    else
-        SERVICE_STATUS="Inactive"
-    fi
+  # Individual service status
+  if systemctl is-active --quiet "$SERVICE_NAME"; then
+    SERVICE_STATUS="Active"
+  else
+    SERVICE_STATUS="Inactive"
+  fi
 
-    if systemctl is-enabled --quiet "$SERVICE_NAME"; then
-        BOOT_STATUS="Enabled"
-    else
-        BOOT_STATUS="Disabled"
-    fi
+  if systemctl is-enabled --quiet "$SERVICE_NAME"; then
+    BOOT_STATUS="Enabled"
+  else
+    BOOT_STATUS="Disabled"
+  fi
 
-    # Show individual service results
-    msg_ok "Service for ${BL}$SELECTED_INTERFACE${GN} (${BL}$DRIVER${GN}) created and enabled!"
-    msg_info "${TAB}Service: ${BL}$SERVICE_NAME${YW}"
-    msg_info "${TAB}Status: ${BL}$SERVICE_STATUS${YW}"
-    msg_info "${TAB}Start on boot: ${BL}$BOOT_STATUS${YW}"
+  # Show individual service results
+  msg_ok "Service for ${BL}$SELECTED_INTERFACE${GN} (${BL}$DRIVER${GN}) created and enabled!"
+  msg_info "${TAB}Service: ${BL}$SERVICE_NAME${YW}"
+  msg_info "${TAB}Status: ${BL}$SERVICE_STATUS${YW}"
+  msg_info "${TAB}Start on boot: ${BL}$BOOT_STATUS${YW}"
 done
 
 # Prepare summary of all interfaces
@@ -209,22 +220,22 @@ SUMMARY_MSG="Services created successfully!\n\n"
 SUMMARY_MSG+="Configured Interfaces:\n"
 
 for iface in "${INTERFACE_ARRAY[@]}"; do
-    SERVICE_NAME="disable-nic-offload-$iface.service"
-    DRIVER=$(basename $(readlink -f /sys/class/net/$iface/device/driver 2>/dev/null) 2>/dev/null)
-    
-    if systemctl is-active --quiet "$SERVICE_NAME"; then
-        SVC_STATUS="Active"
-    else
-        SVC_STATUS="Inactive"
-    fi
+  SERVICE_NAME="disable-nic-offload-$iface.service"
+  DRIVER=$(basename $(readlink -f /sys/class/net/$iface/device/driver 2>/dev/null) 2>/dev/null)
 
-    if systemctl is-enabled --quiet "$SERVICE_NAME"; then
-        BOOT_SVC_STATUS="Enabled"
-    else
-        BOOT_SVC_STATUS="Disabled"
-    fi
+  if systemctl is-active --quiet "$SERVICE_NAME"; then
+    SVC_STATUS="Active"
+  else
+    SVC_STATUS="Inactive"
+  fi
 
-    SUMMARY_MSG+="- $iface ($DRIVER): $SVC_STATUS, Boot: $BOOT_SVC_STATUS\n"
+  if systemctl is-enabled --quiet "$SERVICE_NAME"; then
+    BOOT_SVC_STATUS="Enabled"
+  else
+    BOOT_SVC_STATUS="Disabled"
+  fi
+
+  SUMMARY_MSG+="- $iface ($DRIVER): $SVC_STATUS, Boot: $BOOT_SVC_STATUS\n"
 done
 
 # Show summary results
@@ -236,8 +247,8 @@ msg_ok "Intel e1000e/e1000 optimization complete for ${#INTERFACE_ARRAY[@]} inte
 echo ""
 msg_info "Verification commands:"
 for iface in "${INTERFACE_ARRAY[@]}"; do
-    echo -e "${TAB}${BL}ethtool -k $iface${CL} ${YW}# Check offloading status${CL}"
-    echo -e "${TAB}${BL}systemctl status disable-nic-offload-$iface.service${CL} ${YW}# Check service status${CL}"
+  echo -e "${TAB}${BL}ethtool -k $iface${CL} ${YW}# Check offloading status${CL}"
+  echo -e "${TAB}${BL}systemctl status disable-nic-offload-$iface.service${CL} ${YW}# Check service status${CL}"
 done
 
 exit 0

tools/pve/pbs3-upgrade.sh

@@ -44,6 +44,10 @@ msg_error() {
   echo -e "${BFR} ${CROSS} ${RD}${msg}${CL}"
 }
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "pbs3-upgrade" "pve"
+
 start_routines() {
   header_info
   CHOICE=$(whiptail --backtitle "Proxmox VE Helper Scripts" --title "PBS 2 BACKUP" --menu "\nMake a backup of /etc/proxmox-backup to ensure that in the worst case, any relevant configuration can be recovered?" 14 58 2 \

tools/pve/pbs4-upgrade.sh

@@ -32,6 +32,10 @@ msg_info() { echo -ne " ${HOLD} ${YW}$1..."; }
 msg_ok() { echo -e "${BFR} ${CM} ${GN}$1${CL}"; }
 msg_error() { echo -e "${BFR} ${CROSS} ${RD}$1${CL}"; }
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "pbs4-upgrade" "pve"
+
 start_routines() {
   header_info
   CHOICE=$(whiptail --backtitle "Proxmox VE Helper Scripts" --title "PBS 3 BACKUP" --menu \

tools/pve/pbs_microcode.sh

@@ -28,6 +28,10 @@ CM="${GN}✓${CL}"
 CROSS="${RD}✗${CL}"
 
 msg_info() { echo -ne " ${HOLD} ${YW}$1..."; }
+
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "pbs-microcode" "pve"
 msg_ok() { echo -e "${BFR} ${CM} ${GN}$1${CL}"; }
 msg_error() { echo -e "${BFR} ${CROSS} ${RD}$1${CL}"; }
 

tools/pve/post-pbs-install.sh

@@ -32,6 +32,10 @@ msg_info() { echo -ne " ${HOLD} ${YW}$1..."; }
 msg_ok() { echo -e "${BFR} ${CM} ${GN}$1${CL}"; }
 msg_error() { echo -e "${BFR} ${CROSS} ${RD}$1${CL}"; }
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "post-pbs-install" "pve"
+
 # ---- helpers ----
 get_pbs_codename() {
   awk -F'=' '/^VERSION_CODENAME=/{print $2}' /etc/os-release

tools/pve/post-pmg-install.sh

@@ -43,6 +43,10 @@ msg_error() {
   echo -e "${BFR} ${CROSS} ${RD}${msg}${CL}"
 }
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "post-pmg-install" "pve"
+
 if ! grep -q "Proxmox Mail Gateway" /etc/issue 2>/dev/null; then
   msg_error "This script is only intended for Proxmox Mail Gateway"
   exit 1

tools/pve/post-pve-install.sh

@@ -44,6 +44,10 @@ msg_error() {
   echo -e "${BFR} ${CROSS} ${RD}${msg}${CL}"
 }
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "post-pve-install" "pve"
+
 get_pve_version() {
   local pve_ver
   pve_ver="$(pveversion | awk -F'/' '{print $2}' | awk -F'-' '{print $1}')"

tools/pve/pve-privilege-converter.sh

@@ -11,7 +11,9 @@ if ! command -v curl >/dev/null 2>&1; then
   apt-get install -y curl >/dev/null 2>&1
 fi
 source <(curl -fsSL https://git.community-scripts.org/community-scripts/ProxmoxVE/raw/branch/main/misc/core.func)
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
 load_functions
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "pve-privilege-converter" "pve"
 
 set -euo pipefail
 shopt -s inherit_errexit nullglob

tools/pve/pve8-upgrade.sh

@@ -44,6 +44,10 @@ msg_error() {
   echo -e "${BFR} ${CROSS} ${RD}${msg}${CL}"
 }
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "pve8-upgrade" "pve"
+
 start_routines() {
   header_info
 

tools/pve/scaling-governor.sh

@@ -5,6 +5,11 @@
 # License: MIT
 # https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
 set -e
+
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "scaling-governor" "pve"
+
 header_info() {
   clear
   cat <<EOF

tools/pve/update-apps.sh

@@ -5,6 +5,8 @@
 # License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
 
 source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/refs/heads/main/misc/core.func)
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "update-apps" "pve"
 
 # =============================================================================
 # CONFIGURATION VARIABLES
@@ -98,14 +100,14 @@ EOF
 
 # Handle command line arguments
 case "${1:-}" in
-  --help|-h)
-    print_usage
-    exit 0
-    ;;
-  --export-config)
-    export_config_json
-    exit 0
-    ;;
+--help | -h)
+  print_usage
+  exit 0
+  ;;
+--export-config)
+  export_config_json
+  exit 0
+  ;;
 esac
 
 # =============================================================================
@@ -202,40 +204,40 @@ msg_ok "Loaded ${#menu_items[@]} containers"
 # Determine container selection based on var_container
 if [[ -n "$var_container" ]]; then
   case "$var_container" in
-    all)
-      # Select all containers with matching tags
-      CHOICE=""
-      for ((i=0; i<${#menu_items[@]}; i+=3)); do
-        CHOICE="$CHOICE ${menu_items[$i]}"
-      done
-      CHOICE=$(echo "$CHOICE" | xargs)
-      ;;
-    all_running)
-      # Select only running containers with matching tags
-      CHOICE=""
-      for ((i=0; i<${#menu_items[@]}; i+=3)); do
-        cid="${menu_items[$i]}"
-        if pct status "$cid" 2>/dev/null | grep -q "running"; then
-          CHOICE="$CHOICE $cid"
-        fi
-      done
-      CHOICE=$(echo "$CHOICE" | xargs)
-      ;;
-    all_stopped)
-      # Select only stopped containers with matching tags
-      CHOICE=""
-      for ((i=0; i<${#menu_items[@]}; i+=3)); do
-        cid="${menu_items[$i]}"
-        if pct status "$cid" 2>/dev/null | grep -q "stopped"; then
-          CHOICE="$CHOICE $cid"
-        fi
-      done
-      CHOICE=$(echo "$CHOICE" | xargs)
-      ;;
-    *)
-      # Assume comma-separated list of container IDs
-      CHOICE=$(echo "$var_container" | tr ',' ' ')
-      ;;
+  all)
+    # Select all containers with matching tags
+    CHOICE=""
+    for ((i = 0; i < ${#menu_items[@]}; i += 3)); do
+      CHOICE="$CHOICE ${menu_items[$i]}"
+    done
+    CHOICE=$(echo "$CHOICE" | xargs)
+    ;;
+  all_running)
+    # Select only running containers with matching tags
+    CHOICE=""
+    for ((i = 0; i < ${#menu_items[@]}; i += 3)); do
+      cid="${menu_items[$i]}"
+      if pct status "$cid" 2>/dev/null | grep -q "running"; then
+        CHOICE="$CHOICE $cid"
+      fi
+    done
+    CHOICE=$(echo "$CHOICE" | xargs)
+    ;;
+  all_stopped)
+    # Select only stopped containers with matching tags
+    CHOICE=""
+    for ((i = 0; i < ${#menu_items[@]}; i += 3)); do
+      cid="${menu_items[$i]}"
+      if pct status "$cid" 2>/dev/null | grep -q "stopped"; then
+        CHOICE="$CHOICE $cid"
+      fi
+    done
+    CHOICE=$(echo "$CHOICE" | xargs)
+    ;;
+  *)
+    # Assume comma-separated list of container IDs
+    CHOICE=$(echo "$var_container" | tr ',' ' ')
+    ;;
   esac
 
   if [[ -z "$CHOICE" ]]; then

tools/pve/update-lxcs.sh

@@ -24,6 +24,11 @@ RD=$(echo "\033[01;31m")
 CM='\xE2\x9C\x94\033'
 GN=$(echo "\033[1;92m")
 CL=$(echo "\033[m")
+
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "update-lxcs" "pve"
+
 header_info
 echo "Loading..."
 whiptail --backtitle "Proxmox VE Helper Scripts" --title "Proxmox VE LXC Updater" --yesno "This Will Update LXC Containers. Proceed?" 10 58

tools/pve/update-repo.sh

@@ -23,6 +23,10 @@ RD=$(echo "\033[01;31m")
 GN=$(echo "\033[1;92m")
 CL=$(echo "\033[m")
 
+# Telemetry
+source <(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func) 2>/dev/null || true
+declare -f init_tool_telemetry &>/dev/null && init_tool_telemetry "update-repo" "pve"
+
 header_info
 echo "Loading..."
 NODE=$(hostname)

vm/truenas-vm.sh

@@ -0,0 +1,624 @@
+#!/usr/bin/env bash
+
+# Copyright (c) 2021-2026 community-scripts ORG
+# Author: juronja
+# License: MIT | https://github.com/community-scripts/ProxmoxVE/raw/main/LICENSE
+# Source: https://www.truenas.com/truenas-community-edition/
+
+source /dev/stdin <<<$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/api.func)
+
+function header_info() {
+  clear
+  cat <<"EOF"
+  ______                _   _____   _____
+ /_  __/______  _____  / | / /   | / ___/
+  / / / ___/ / / / _ \/  |/ / /| | \__ \
+ / / / /  / /_/ /  __/ /|  / ___ |___/ /
+/_/ /_/   \__,_/\___/_/ |_/_/  |_/____/
+                                           (Community Edition)
+EOF
+}
+header_info
+echo -e "\n Loading..."
+GEN_MAC=02:$(openssl rand -hex 5 | awk '{print toupper($0)}' | sed 's/\(..\)/\1:/g; s/.$//')
+RANDOM_UUID="$(cat /proc/sys/kernel/random/uuid)"
+METHOD=""
+
+YW=$(echo "\033[33m")
+BL=$(echo "\033[36m")
+RD=$(echo "\033[01;31m")
+BGN=$(echo "\033[4;92m")
+GN=$(echo "\033[1;92m")
+DGN=$(echo "\033[32m")
+CL=$(echo "\033[m")
+
+CL=$(echo "\033[m")
+BOLD=$(echo "\033[1m")
+BFR="\\r\\033[K"
+HOLD=" "
+TAB="  "
+
+CM="${TAB}✔️${TAB}${CL}"
+CROSS="${TAB}✖️${TAB}${CL}"
+INFO="${TAB}💡${TAB}${CL}"
+OS="${TAB}🖥️${TAB}${CL}"
+CONTAINERTYPE="${TAB}📦${TAB}${CL}"
+ISO="${TAB}📀${TAB}${CL}"
+DISKSIZE="${TAB}💾${TAB}${CL}"
+CPUCORE="${TAB}🧠${TAB}${CL}"
+RAMSIZE="${TAB}🛠️${TAB}${CL}"
+CONTAINERID="${TAB}🆔${TAB}${CL}"
+HOSTNAME="${TAB}🏠${TAB}${CL}"
+BRIDGE="${TAB}🌉${TAB}${CL}"
+GATEWAY="${TAB}🌐${TAB}${CL}"
+DISK="${TAB}💽${TAB}${CL}"
+DEFAULT="${TAB}⚙️${TAB}${CL}"
+MACADDRESS="${TAB}🔗${TAB}${CL}"
+VLANTAG="${TAB}🏷️${TAB}${CL}"
+CREATING="${TAB}🚀${TAB}${CL}"
+ADVANCED="${TAB}🧩${TAB}${CL}"
+CLOUD="${TAB}☁️${TAB}${CL}"
+
+set -e
+trap 'error_handler $LINENO "$BASH_COMMAND"' ERR
+trap cleanup EXIT
+trap 'post_update_to_api "failed" "INTERRUPTED"' SIGINT
+trap 'post_update_to_api "failed" "TERMINATED"' SIGTERM
+function error_handler() {
+  local exit_code="$?"
+  local line_number="$1"
+  local command="$2"
+  local error_message="${RD}[ERROR]${CL} in line ${RD}$line_number${CL}: exit code ${RD}$exit_code${CL}: while executing command ${YW}$command${CL}"
+  post_update_to_api "failed" "${command}"
+  echo -e "\n$error_message\n"
+  cleanup_vmid
+}
+
+function truenas_iso_lookup() {
+  local BASE_URL="https://download.truenas.com"
+  local current_year=$(date +%y)
+  local last_year=$(date -d "1 year ago" +%y)
+  local year_pattern="${current_year}\.|${last_year}\."
+
+  declare -A latest_stables
+  local pre_releases=()
+
+  local all_paths=$(
+    curl -sL "$BASE_URL" |
+      grep -oE 'href="[^"]+\.iso"' |
+      sed 's/href="//; s/"$//' |
+      grep -vE '(nightly|ALPHA)' |
+      grep -E "$year_pattern"
+  )
+
+  while read -r path; do
+    local filename=$(basename "$path")
+    local version=$(echo "$filename" | sed -E 's/.*TrueNAS-SCALE-([0-9]{2}\.[0-9]{2}(\.[0-9]+)*(-RC[0-9]|-BETA[0-9])?)\.iso.*/\1/')
+    if [[ "$version" =~ (RC|BETA) ]]; then
+      pre_releases+=("$path")
+    else
+      local major_version=$(echo "$version" | cut -d'.' -f1,2)
+      local current_stored_path=${latest_stables["$major_version"]}
+      if [[ -z "$current_stored_path" ]]; then
+        latest_stables["$major_version"]="$path"
+      else
+        local stored_version=$(basename "$current_stored_path" | sed -E 's/.*TrueNAS-SCALE-([0-9]{2}\.[0-9]{2}(\.[0-9]+)*)\.iso.*/\1/')
+        if printf '%s\n' "$version" "$stored_version" | sort -V | tail -n 1 | grep -q "$version"; then
+          latest_stables["$major_version"]="$path"
+        fi
+      fi
+    fi
+  done <<<"$all_paths"
+
+  for key in "${!latest_stables[@]}"; do
+    echo "${latest_stables[$key]#/}"
+  done
+
+  for pre in "${pre_releases[@]}"; do
+    echo "${pre#/}"
+  done | sort -V
+}
+
+function get_valid_nextid() {
+  local try_id
+  try_id=$(pvesh get /cluster/nextid)
+  while true; do
+    if [ -f "/etc/pve/qemu-server/${try_id}.conf" ] || [ -f "/etc/pve/lxc/${try_id}.conf" ]; then
+      try_id=$((try_id + 1))
+      continue
+    fi
+    if lvs --noheadings -o lv_name | grep -qE "(^|[-_])${try_id}($|[-_])"; then
+      try_id=$((try_id + 1))
+      continue
+    fi
+    break
+  done
+  echo "$try_id"
+}
+
+function cleanup_vmid() {
+  if qm status $VMID &>/dev/null; then
+    qm stop $VMID &>/dev/null
+    qm destroy $VMID &>/dev/null
+  fi
+}
+
+function cleanup() {
+  popd >/dev/null
+  post_update_to_api "done" "none"
+  rm -rf $TEMP_DIR
+}
+
+TEMP_DIR=$(mktemp -d)
+pushd $TEMP_DIR >/dev/null
+if whiptail --backtitle "Proxmox VE Helper Scripts" --title "TrueNAS VM" --yesno "This will create a New TrueNAS VM. Proceed?" 10 58; then
+  :
+else
+  header_info && echo -e "${CROSS}${RD}User exited script${CL}\n" && exit
+fi
+
+function msg_info() {
+  local msg="$1"
+  echo -ne "${TAB}${YW}${HOLD}${msg}${HOLD}"
+}
+
+function msg_ok() {
+  local msg="$1"
+  echo -e "${BFR}${CM}${GN}${msg}${CL}"
+}
+
+function msg_error() {
+  local msg="$1"
+  echo -e "${BFR}${CROSS}${RD}${msg}${CL}"
+}
+
+function check_root() {
+  if [[ "$(id -u)" -ne 0 || $(ps -o comm= -p $PPID) == "sudo" ]]; then
+    clear
+    msg_error "Please run this script as root."
+    echo -e "\nExiting..."
+    sleep 2
+    exit
+  fi
+}
+
+function pve_check() {
+  local PVE_VER
+  PVE_VER="$(pveversion | awk -F'/' '{print $2}' | awk -F'-' '{print $1}')"
+
+  if [[ "$PVE_VER" =~ ^8\.([0-9]+) ]]; then
+    local MINOR="${BASH_REMATCH[1]}"
+    if ((MINOR < 0 || MINOR > 9)); then
+      msg_error "This version of Proxmox VE is not supported."
+      msg_error "Supported: Proxmox VE version 8.0 – 8.9"
+      exit 1
+    fi
+    return 0
+  fi
+
+  if [[ "$PVE_VER" =~ ^9\.([0-9]+) ]]; then
+    local MINOR="${BASH_REMATCH[1]}"
+    if ((MINOR < 0 || MINOR > 1)); then
+      msg_error "This version of Proxmox VE is not yet supported."
+      msg_error "Supported: Proxmox VE version 9.0 – 9.1"
+      exit 1
+    fi
+    return 0
+  fi
+
+  msg_error "This version of Proxmox VE is not supported."
+  msg_error "Supported versions: Proxmox VE 8.0 – 8.x or 9.0 – 9.1"
+  exit 1
+}
+
+function arch_check() {
+  if [ "$(dpkg --print-architecture)" != "amd64" ]; then
+    echo -e "\n ${INFO}${YWB}This script will not work with PiMox! \n"
+    echo -e "\n ${YWB}Visit https://github.com/asylumexp/Proxmox for ARM64 support. \n"
+    echo -e "Exiting..."
+    sleep 2
+    exit
+  fi
+}
+
+function ssh_check() {
+  if command -v pveversion >/dev/null 2>&1; then
+    if [ -n "${SSH_CLIENT:+x}" ]; then
+      if whiptail --backtitle "Proxmox VE Helper Scripts" --defaultno --title "SSH DETECTED" --yesno "It's suggested to use the Proxmox shell instead of SSH, since SSH can create issues while gathering variables. Would you like to proceed with using SSH?" 10 62; then
+        echo "you've been warned"
+      else
+        clear
+        exit
+      fi
+    fi
+  fi
+}
+
+function exit-script() {
+  clear
+  echo -e "\n${CROSS}${RD}User exited script${CL}\n"
+  exit
+}
+
+function default_settings() {
+  VMID=$(get_valid_nextid)
+  ISO_DEFAULT="latest stable"
+  FORMAT=""
+  MACHINE="q35"
+  DISK_SIZE="16"
+  HN="truenas"
+  CPU_TYPE="host"
+  CORE_COUNT="2"
+  RAM_SIZE="8192"
+  BRG="vmbr0"
+  MAC="$GEN_MAC"
+  VLAN=""
+  MTU=""
+  START_VM="yes"
+  METHOD="default"
+  echo -e "${CONTAINERID}${BOLD}${DGN}Virtual Machine ID: ${BGN}${VMID}${CL}"
+  echo -e "${ISO}${BOLD}${DGN}ISO Chosen: ${BGN}${ISO_DEFAULT}${CL}"
+  echo -e "${CONTAINERTYPE}${BOLD}${DGN}Machine Type: ${BGN}${MACHINE}${CL}"
+  echo -e "${DISKSIZE}${BOLD}${DGN}Disk Size: ${BGN}${DISK_SIZE}${CL}"
+  echo -e "${HOSTNAME}${BOLD}${DGN}Hostname: ${BGN}${HN}${CL}"
+  echo -e "${OS}${BOLD}${DGN}CPU Model: ${BGN}${CPU_TYPE}${CL}"
+  echo -e "${CPUCORE}${BOLD}${DGN}CPU Cores: ${BGN}${CORE_COUNT}${CL}"
+  echo -e "${RAMSIZE}${BOLD}${DGN}RAM Size: ${BGN}${RAM_SIZE}${CL}"
+  echo -e "${BRIDGE}${BOLD}${DGN}Bridge: ${BGN}${BRG}${CL}"
+  echo -e "${MACADDRESS}${BOLD}${DGN}MAC Address: ${BGN}${MAC}${CL}"
+  echo -e "${VLANTAG}${BOLD}${DGN}VLAN: ${BGN}Default${CL}"
+  echo -e "${DEFAULT}${BOLD}${DGN}Interface MTU Size: ${BGN}Default${CL}"
+  echo -e "${GATEWAY}${BOLD}${DGN}Start VM when completed: ${BGN}yes${CL}"
+  echo -e "${CREATING}${BOLD}${DGN}Creating a TrueNAS VM using the above default settings${CL}"
+}
+
+function advanced_settings() {
+  DISK_SIZE="16"
+  HN="truenas"
+  CORE_COUNT="2"
+  RAM_SIZE="8192"
+  BRG="vmbr0"
+
+  METHOD="advanced"
+  [ -z "${VMID:-}" ] && VMID=$(get_valid_nextid)
+  while true; do
+    if VMID=$(whiptail --backtitle "Proxmox VE Helper Scripts" --inputbox "Set Virtual Machine ID" 8 58 $VMID --title "VIRTUAL MACHINE ID" --cancel-button Exit-Script 3>&1 1>&2 2>&3); then
+      if [ -z "$VMID" ]; then
+        VMID=$(get_valid_nextid)
+      fi
+      if pct status "$VMID" &>/dev/null || qm status "$VMID" &>/dev/null; then
+        echo -e "${CROSS}${RD} ID $VMID is already in use${CL}"
+        sleep 2
+        continue
+      fi
+      echo -e "${CONTAINERID}${BOLD}${DGN}Virtual Machine ID: ${BGN}$VMID${CL}"
+      break
+    else
+      exit-script
+    fi
+  done
+
+  ISOARRAY=()
+  mapfile -t ALL_ISOS < <(truenas_iso_lookup | sort -V)
+  ISO_COUNT=${#ALL_ISOS[@]}
+
+  if [ $ISO_COUNT -eq 0 ]; then
+    echo "No ISOs found."
+    exit 1
+  fi
+
+  # Identify the index of the last stable release
+  LAST_STABLE_INDEX=-1
+  for i in "${!ALL_ISOS[@]}"; do
+    if [[ ! "${ALL_ISOS[$i]}" =~ (BETA|RC) ]]; then
+      LAST_STABLE_INDEX=$i
+    fi
+  done
+
+  # Build the whiptail array
+  for i in "${!ALL_ISOS[@]}"; do
+    ISOPATH="${ALL_ISOS[$i]}"
+    FILENAME=$(basename "$ISOPATH")
+
+    # Select ON if it's the last stable found, OR fallback to last item if no stable exists
+    if [[ "$i" -eq "$LAST_STABLE_INDEX" ]]; then
+      ISOARRAY+=("$ISOPATH" "$FILENAME" "ON")
+    elif [[ "$LAST_STABLE_INDEX" -eq -1 && "$i" -eq "$((ISO_COUNT - 1))" ]]; then
+      # Fallback: if somehow no stable is found, select the very last item
+      ISOARRAY+=("$ISOPATH" "$FILENAME" "ON")
+    else
+      ISOARRAY+=("$ISOPATH" "$FILENAME" "OFF")
+    fi
+  done
+
+  if SELECTED_ISO=$(whiptail --backtitle "Proxmox VE Helper Scripts" --title "SELECT ISO TO INSTALL" --notags --radiolist "\nSelect version (BETA/RC/Latest stable):" 20 58 12 "${ISOARRAY[@]}" --cancel-button Exit-Script 3>&1 1>&2 2>&3); then
+    echo -e "${ISO}${BOLD}${DGN}ISO Chosen: ${BGN}$(basename "$SELECTED_ISO")${CL}"
+  else
+    exit-script
+  fi
+
+  if DISK_SIZE=$(whiptail --backtitle "Proxmox VE Helper Scripts" --inputbox "Set Disk Size in GiB (e.g., 10, 20)" 8 58 "$DISK_SIZE" --title "DISK SIZE" --cancel-button Exit-Script 3>&1 1>&2 2>&3); then
+    DISK_SIZE=$(echo "$DISK_SIZE" | tr -d ' ')
+    if [[ "$DISK_SIZE" =~ ^[0-9]+$ ]]; then
+      echo -e "${DISKSIZE}${BOLD}${DGN}Disk Size: ${BGN}$DISK_SIZE${CL}"
+    else
+      echo -e "${DISKSIZE}${BOLD}${RD}Invalid Disk Size. Please use a number (e.g., 10).${CL}"
+      exit-script
+    fi
+  else
+    exit-script
+  fi
+
+  if VM_NAME=$(whiptail --backtitle "Proxmox VE Helper Scripts" --inputbox "Set Hostname" 8 58 "$HN" --title "HOSTNAME" --cancel-button Exit-Script 3>&1 1>&2 2>&3); then
+    if [ -z $VM_NAME ]; then
+      echo -e "${HOSTNAME}${BOLD}${DGN}Hostname: ${BGN}$HN${CL}"
+    else
+      HN=$(echo ${VM_NAME,,} | tr -d ' ')
+      echo -e "${HOSTNAME}${BOLD}${DGN}Hostname: ${BGN}$HN${CL}"
+    fi
+  else
+    exit-script
+  fi
+
+  if CPU_TYPE1=$(whiptail --backtitle "Proxmox VE Helper Scripts" --title "CPU MODEL" --radiolist "Choose CPU Model" --cancel-button Exit-Script 10 58 2 \
+    "KVM64" "Default – safe for migration/compatibility" OFF \
+    "Host" "Use host CPU features (faster, no migration)" ON \
+    3>&1 1>&2 2>&3); then
+    case "$CPU_TYPE1" in
+    Host)
+      echo -e "${OS}${BOLD}${DGN}CPU Model: ${BGN}Host${CL}"
+      CPU_TYPE="host"
+      ;;
+    *)
+      echo -e "${OS}${BOLD}${DGN}CPU Model: ${BGN}KVM64${CL}"
+      CPU_TYPE=""
+      ;;
+    esac
+  else
+    exit-script
+  fi
+
+  if CORE_COUNT=$(whiptail --backtitle "Proxmox VE Helper Scripts" --inputbox "Allocate CPU Cores" 8 58 "$CORE_COUNT" --title "CORE COUNT" --cancel-button Exit-Script 3>&1 1>&2 2>&3); then
+    if [ -z $CORE_COUNT ]; then
+      CORE_COUNT="2"
+      echo -e "${CPUCORE}${BOLD}${DGN}CPU Cores: ${BGN}$CORE_COUNT${CL}"
+    else
+      echo -e "${CPUCORE}${BOLD}${DGN}CPU Cores: ${BGN}$CORE_COUNT${CL}"
+    fi
+  else
+    exit-script
+  fi
+
+  if RAM_SIZE=$(whiptail --backtitle "Proxmox VE Helper Scripts" --inputbox "Allocate RAM in MiB" 8 58 "$RAM_SIZE" --title "RAM" --cancel-button Exit-Script 3>&1 1>&2 2>&3); then
+    if [ -z $RAM_SIZE ]; then
+      RAM_SIZE="8192"
+      echo -e "${RAMSIZE}${BOLD}${DGN}RAM Size: ${BGN}$RAM_SIZE${CL}"
+    else
+      echo -e "${RAMSIZE}${BOLD}${DGN}RAM Size: ${BGN}$RAM_SIZE${CL}"
+    fi
+  else
+    exit-script
+  fi
+
+  if BRG=$(whiptail --backtitle "Proxmox VE Helper Scripts" --inputbox "Set a Bridge" 8 58 "$BRG" --title "BRIDGE" --cancel-button Exit-Script 3>&1 1>&2 2>&3); then
+    if [ -z $BRG ]; then
+      BRG="vmbr0"
+      echo -e "${BRIDGE}${BOLD}${DGN}Bridge: ${BGN}$BRG${CL}"
+    else
+      echo -e "${BRIDGE}${BOLD}${DGN}Bridge: ${BGN}$BRG${CL}"
+    fi
+  else
+    exit-script
+  fi
+
+  if MAC1=$(whiptail --backtitle "Proxmox VE Helper Scripts" --inputbox "Set a MAC Address" 8 58 $GEN_MAC --title "MAC ADDRESS" --cancel-button Exit-Script 3>&1 1>&2 2>&3); then
+    if [ -z $MAC1 ]; then
+      MAC="$GEN_MAC"
+      echo -e "${MACADDRESS}${BOLD}${DGN}MAC Address: ${BGN}$MAC${CL}"
+    else
+      MAC="$MAC1"
+      echo -e "${MACADDRESS}${BOLD}${DGN}MAC Address: ${BGN}$MAC1${CL}"
+    fi
+  else
+    exit-script
+  fi
+
+  if VLAN1=$(whiptail --backtitle "Proxmox VE Helper Scripts" --inputbox "Set a Vlan(leave blank for default)" 8 58 --title "VLAN" --cancel-button Exit-Script 3>&1 1>&2 2>&3); then
+    if [ -z $VLAN1 ]; then
+      VLAN1="Default"
+      VLAN=""
+      echo -e "${VLANTAG}${BOLD}${DGN}VLAN: ${BGN}$VLAN1${CL}"
+    else
+      VLAN=",tag=$VLAN1"
+      echo -e "${VLANTAG}${BOLD}${DGN}VLAN: ${BGN}$VLAN1${CL}"
+    fi
+  else
+    exit-script
+  fi
+
+  if MTU1=$(whiptail --backtitle "Proxmox VE Helper Scripts" --inputbox "Set Interface MTU Size (leave blank for default)" 8 58 --title "MTU SIZE" --cancel-button Exit-Script 3>&1 1>&2 2>&3); then
+    if [ -z $MTU1 ]; then
+      MTU1="Default"
+      MTU=""
+      echo -e "${DEFAULT}${BOLD}${DGN}Interface MTU Size: ${BGN}$MTU1${CL}"
+    else
+      MTU=",mtu=$MTU1"
+      echo -e "${DEFAULT}${BOLD}${DGN}Interface MTU Size: ${BGN}$MTU1${CL}"
+    fi
+  else
+    exit-script
+  fi
+
+  if (whiptail --backtitle "Proxmox VE Helper Scripts" --defaultno --title "IMPORT ONBOARD DISKS" --yesno "Would you like to import onboard disks?" 10 58); then
+    echo -e "${DISK}${BOLD}${DGN}Import onboard disks: ${BGN}yes${CL}"
+    IMPORT_DISKS="yes"
+  else
+    echo -e "${DISK}${BOLD}${DGN}Import onboard disks: ${BGN}no${CL}"
+    IMPORT_DISKS="no"
+  fi
+
+  if (whiptail --backtitle "Proxmox VE Helper Scripts" --title "START VIRTUAL MACHINE" --yesno "Start VM when completed?" 10 58); then
+    echo -e "${GATEWAY}${BOLD}${DGN}Start VM when completed: ${BGN}yes${CL}"
+    START_VM="yes"
+  else
+    echo -e "${GATEWAY}${BOLD}${DGN}Start VM when completed: ${BGN}no${CL}"
+    START_VM="no"
+  fi
+
+  if (whiptail --backtitle "Proxmox VE Helper Scripts" --title "ADVANCED SETTINGS COMPLETE" --yesno "Ready to create a TrueNAS VM?" --no-button Do-Over 10 58); then
+    echo -e "${CREATING}${BOLD}${DGN}Creating a TrueNAS VM using the above advanced settings${CL}"
+  else
+    header_info
+    echo -e "${ADVANCED}${BOLD}${RD}Using Advanced Settings${CL}"
+    advanced_settings
+  fi
+}
+
+function start_script() {
+  if (whiptail --backtitle "Proxmox VE Helper Scripts" --title "SETTINGS" --yesno "Use Default Settings?" --no-button Advanced 10 58); then
+    header_info
+    echo -e "${DEFAULT}${BOLD}${BL}Using Default Settings${CL}"
+    default_settings
+  else
+    header_info
+    echo -e "${ADVANCED}${BOLD}${RD}Using Advanced Settings${CL}"
+    advanced_settings
+  fi
+}
+check_root
+arch_check
+pve_check
+ssh_check
+start_script
+post_to_api_vm
+
+msg_info "Validating Storage"
+while read -r line; do
+  TAG=$(echo $line | awk '{print $1}')
+  TYPE=$(echo $line | awk '{printf "%-10s", $2}')
+  FREE=$(echo $line | numfmt --field 4-6 --from-unit=K --to=iec --format %.2f | awk '{printf( "%9sB", $6)}')
+  ITEM="  Type: $TYPE Free: $FREE "
+  OFFSET=2
+  if [[ $((${#ITEM} + $OFFSET)) -gt ${MSG_MAX_LENGTH:-} ]]; then
+    MSG_MAX_LENGTH=$((${#ITEM} + $OFFSET))
+  fi
+  STORAGE_MENU+=("$TAG" "$ITEM" "OFF")
+done < <(pvesm status -content images | awk 'NR>1')
+VALID=$(pvesm status -content images | awk 'NR>1')
+if [ -z "$VALID" ]; then
+  msg_error "Unable to detect a valid storage location."
+  exit
+elif [ $((${#STORAGE_MENU[@]} / 3)) -eq 1 ]; then
+  STORAGE=${STORAGE_MENU[0]}
+else
+  while [ -z "${STORAGE:+x}" ]; do
+    if [ -n "$SPINNER_PID" ] && ps -p $SPINNER_PID >/dev/null; then kill $SPINNER_PID >/dev/null; fi
+    printf "\e[?25h"
+    STORAGE=$(whiptail --backtitle "Proxmox VE Helper Scripts" --title "Storage Pools" --radiolist \
+      "Which storage pool would you like to use for ${HN}?\nTo make a selection, use the Spacebar.\n" \
+      16 $(($MSG_MAX_LENGTH + 23)) 6 \
+      "${STORAGE_MENU[@]}" 3>&1 1>&2 2>&3)
+  done
+fi
+msg_ok "Using ${CL}${BL}$STORAGE${CL} ${GN}for Storage Location."
+msg_ok "Virtual Machine ID is ${CL}${BL}$VMID${CL}."
+
+if [ -z "${SELECTED_ISO:-}" ]; then
+  SELECTED_ISO=$(truenas_iso_lookup | grep -vE 'RC|BETA' | sort -V | tail -n 1)
+
+  if [ -z "$SELECTED_ISO" ]; then
+    msg_error "Could not find a stable ISO for fallback."
+    exit 1
+  fi
+fi
+
+FULL_URL="https://download.truenas.com/${SELECTED_ISO#/}"
+ISO_NAME=$(basename "$FULL_URL")
+CACHE_DIR="/var/lib/vz/template/iso"
+CACHE_FILE="$CACHE_DIR/$ISO_NAME"
+
+if [[ ! -s "$CACHE_FILE" ]]; then
+  msg_info "Retrieving the ISO for the TrueNAS Disk Image"
+  curl -f#SL -o "$CACHE_FILE" "$FULL_URL"
+  msg_ok "Downloaded ${CL}${BL}$(basename "$CACHE_FILE")${CL}"
+else
+  msg_ok "Using cached image ${CL}${BL}$(basename "$CACHE_FILE")${CL}"
+fi
+
+set -o pipefail
+msg_info "Creating TrueNAS VM shell"
+qm create "$VMID" -machine q35 -bios ovmf -agent enabled=1 -tablet 0 -localtime 1 -cpu "$CPU_TYPE" \
+  -cores "$CORE_COUNT" -memory "$RAM_SIZE" -balloon 0 -name "$HN" -tags community-script \
+  -net0 "virtio,bridge=$BRG,macaddr=$MAC$VLAN$MTU" -onboot 1 -ostype l26 \
+  -efidisk0 $STORAGE:1,efitype=4m,pre-enrolled-keys=0 -sata0 $STORAGE:$DISK_SIZE,ssd=1 \
+  -scsihw virtio-scsi-single -cdrom local:iso/$ISO_NAME -vga virtio >/dev/null
+msg_ok "Created VM shell"
+
+if [ "$IMPORT_DISKS" == "yes" ]; then
+  msg_info "Importing onboard disks"
+  DISKARRAY=()
+  SCSI_NR=0
+
+  while read -r LSOUTPUT; do
+    TRUNCATED="${LSOUTPUT:0:45}"
+    if [ ${#LSOUTPUT} -gt 45 ]; then
+      TRUNCATED="${TRUNCATED}..."
+    fi
+    DISKARRAY+=("$LSOUTPUT" "$TRUNCATED" "OFF")
+  done < <(ls /dev/disk/by-id | grep -E '^ata-|^nvme-|^usb-' | grep -v 'part')
+
+  SELECTIONS=$(whiptail --backtitle "Proxmox VE Helper Scripts" --title "SELECT DISKS TO IMPORT" --checklist "\nSelect disk IDs to import. (Use Spacebar to select)\n" --notags --cancel-button "Exit Script" 20 58 10 "${DISKARRAY[@]}" 3>&1 1>&2 2>&3 | tr -d '"') || exit
+
+  for SELECTION in $SELECTIONS; do
+    ((++SCSI_NR))
+
+    ID_SERIAL=$(udevadm info --query=property --value --property=ID_SERIAL_SHORT "/dev/disk/by-id/$SELECTION")
+    ID_SERIAL=${ID_SERIAL:0:20}
+
+    qm set $VMID --scsi$SCSI_NR /dev/disk/by-id/$SELECTION,serial=$ID_SERIAL
+  done
+  msg_ok "Disks imported successfully"
+fi
+
+DESCRIPTION=$(
+  cat <<EOF
+<div align='center'>
+  <a href='https://Helper-Scripts.com' target='_blank' rel='noopener noreferrer'>
+    <img src='https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/misc/images/logo-81x112.png' alt='Logo' style='width:81px;height:112px;'/>
+  </a>
+
+  <h2 style='font-size: 24px; margin: 20px 0;'>TrueNAS Community Edition</h2>
+
+  <p style='margin: 16px 0;'>
+    <a href='https://ko-fi.com/community_scripts' target='_blank' rel='noopener noreferrer'>
+      <img src='https://img.shields.io/badge/&#x2615;-Buy us a coffee-blue' alt='spend Coffee' />
+    </a>
+  </p>
+
+  <span style='margin: 0 10px;'>
+    <i class="fa fa-github fa-fw" style="color: #f5f5f5;"></i>
+    <a href='https://github.com/community-scripts/ProxmoxVE' target='_blank' rel='noopener noreferrer' style='text-decoration: none; color: #00617f;'>GitHub</a>
+  </span>
+  <span style='margin: 0 10px;'>
+    <i class="fa fa-comments fa-fw" style="color: #f5f5f5;"></i>
+    <a href='https://github.com/community-scripts/ProxmoxVE/discussions' target='_blank' rel='noopener noreferrer' style='text-decoration: none; color: #00617f;'>Discussions</a>
+  </span>
+  <span style='margin: 0 10px;'>
+    <i class="fa fa-exclamation-circle fa-fw" style="color: #f5f5f5;"></i>
+    <a href='https://github.com/community-scripts/ProxmoxVE/issues' target='_blank' rel='noopener noreferrer' style='text-decoration: none; color: #00617f;'>Issues</a>
+  </span>
+</div>
+EOF
+)
+qm set "$VMID" -description "$DESCRIPTION" >/dev/null
+
+sleep 3
+
+msg_ok "Created a TrueNAS VM ${CL}${BL}(${HN})"
+if [ "$START_VM" == "yes" ]; then
+  msg_info "Starting TrueNAS VM"
+  qm start $VMID
+  msg_ok "Started TrueNAS VM"
+fi
+
+msg_ok "Completed Successfully!\n"