🚀 v0.7.3 — Enhanced Backup Path Validation & Error Diagnostics

This release introduces advanced diagnostics and validation logic for all secondary and cloud backup paths, ensuring clear error messages, automatic fallback handling, and smarter failure prevention across all modules.
It also improves installation reliability by fixing silent termination issues and refining interactive prompt visibility during setup.

⚙️ Main Script

/script/proxmox-backup.sh

Added

• ✅ Added validate_backup_paths() call after setup_dirs() to validate configuration before any backup operation.
• 🚦 Early detection of misconfigured or empty backup paths prevents runtime failures and ensures graceful auto-disable behavior.

🧩 Core Libraries

/lib/storage.sh

Added

• 🧩 New validate_backup_paths() function (lines 465–518) centralizes validation for all backup targets (Primary, Secondary, Cloud).
• ⚙️ Automatic path validation on startup with clear status and auto-disable logic when directories are missing or not configured.
• ⚠️ Added detailed, actionable warning messages:
  • WARNING No secondary backup path specified
  • WARNING No secondary log path specified
  • WARNING No cloud backup path specified
  • WARNING No rclone remote specified
    Followed by matching INFO Secondary/Cloud backup is disabled.

Fixed

• 🧰 Removed 2>/dev/null suppression from directory creation and path checks to reveal real system error messages.
• 🧾 Enhanced diagnostics for mkdir errors — now report parent permissions, ownership, free space, and mount options.
• 🧩 Fixed issue where empty SECONDARY_LOG_PATH or CLOUD_LOG_PATH produced cryptic mkdir: cannot create directory '' messages.

Behavior

• 💡 Misconfigured backups are now automatically disabled with clear context.
• 🔍 Transforms generic mkdir errors into human-readable, self-explanatory warnings.

/lib/environment.sh

Added

• 🔧 Integrated validate_backup_paths() for centralized startup validation and dynamic configuration checks.

/lib/backup_collect_pbspve.sh

Fixed

• 🧾 Collection process now saves find stderr/exit status into temp files and passes cause details to handle_collection_error().
• 💬 Warnings now immediately show if the issue is due to SIGPIPE (>20 directories), permission errors, or missing mounts.
• 📊 Disk usage calculation now captures du errors and prints # CAUSE: … in metadata, optionally attaching df -h output for visibility on offline mounts or missing permissions.

Behavior

• 🧠 Metadata still lists the first 20 directories, but when scan errors occur, logs are self-explanatory and the Disk Usage block includes fallback diagnostics.

🧰 Standalone Scripts

/script/install.sh

Fixed

• 🧩 Resolved silent script termination when commands failed in non-verbose mode.
• 🔄 Fixed script hanging on security-check.sh interactive prompts during installation.
• 🧾 Improved error handling in install_dependencies() for:
  apt update, apt install, apt upgrade, rclone installer, wget, tar, configure/make/make install.
• 🧰 Modified create_backup() and clone_repository() to capture and show command output on failure.
• 🔧 Adjusted stderr redirection in run_fix_permissions(), run_security_check(), and run_first_backup() to allow prompts while keeping normal output silent.

Added

• 📦 Added missing dependencies (iptables, net-tools, iproute2) for security-check.sh.
• 💬 Added local variables to capture detailed command output (apt_output, rclone_output, build_output, git_output, etc.).

Behavior

• 🚫 Silent mode now shows full, contextual error messages instead of failing silently.
• 🧭 Interactive prompts are visible even in silent mode, avoiding hangs.
• ⚙️ All required dependencies are auto-installed, ensuring smooth setup without manual input.

✅ Overall Improvements

• 🧩 Centralized and transparent validation for all backup paths.
• 🧭 Human-readable diagnostics for missing or invalid directories.
• 🧰 Safer and clearer error handling during installation and execution.
• 🧾 Enhanced feedback for permission, space, and mount errors.
• ⚙️ Improved user experience through early detection and automatic recovery logic.

✨ Result: The system is now more resilient, self-diagnosing, and user-friendly, with crystal-clear warnings and fully automated fallback handling for misconfigured backup paths.

Compatibility: PVE and PBS
Installation:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/tis24dev/proxmox-backup/main/install.sh)"