PiHoleVault v1.7.2

🚀 PiHoleVault v1.7.2

[1.7.2] - 2025-12-12

🐛 Bug Fixes

• Fixed corrupted backup files: Resolved critical issue where Pi-hole backup files were being corrupted during download. The axios HTTP client was treating binary data as UTF-8 text, causing ~40% of bytes to be replaced with invalid characters (0xFD). Fixed by adding responseType: 'arraybuffer' to properly handle binary data streams.

• Improved backup validation: Enhanced isValidBackupData() function to properly validate Buffer data by checking for valid archive magic numbers (ZIP, GZIP, TAR).

🔧 Technical Changes

• Updated PiHoleWebService.js to use arraybuffer response type for backup downloads
• Proper ArrayBuffer to Buffer conversion for file writing
• Improved npm install output visibility in Dockerfile for better build debugging

---

Full Changelog: View all changes

PiHoleVault v1.7.1

🚀 PiHoleVault v1.7.1

Automatically generated release from version file update.

Changes

• Updated to version 1.7.1
• See commit history for detailed changes

Full Changelog: View all changes

PiHoleVault v1.7.0

🎯 Version 1.7.0 Release - Web-Only Connection Method & Pi-hole Modern API Support

This groundbreaking release introduces a revolutionary new connection method that eliminates the need for SSH access, making PiHoleVault perfect for Docker Pi-hole installations and containerized environments.

✨ Major New Features

• 🌐 Web-Only Connection Method:

  • Complete backup solution requiring NO SSH access
  • Perfect for Docker Pi-hole installations where SSH is unavailable
  • Uses Pi-hole's modern web API for authentication and backup operations
  • Supports both HTTP and HTTPS connections with automatic endpoint discovery

• 🔗 Pi-hole Modern API Integration:

  • Native support for Pi-hole v6.0+ modern API endpoints
  • Session-based authentication with SID and CSRF token handling
  • Automatic fallback to legacy API endpoints for older Pi-hole versions
  • Teleporter API integration for seamless backup data retrieval

• ⚡ Three Connection Methods Available:

  1. Web-Only: Pure API-based connection (no SSH required)
  2. Web+SSH Hybrid: Web authentication + SSH backup (enhanced security)
  3. Traditional SSH: Original SSH-only method (fully backward compatible)

• 🐳 Docker Pi-hole Ready:

  • Designed specifically for containerized Pi-hole environments
  • No container modification or SSH daemon installation required
  • Works with official Pi-hole Docker images out of the box
  • Automatic network connectivity and DNS resolution

🔧 Technical Implementation

• PiHoleWebService: New dedicated service for Pi-hole web API interactions
• Session Management: Sophisticated cookie and token handling system
• Multi-Endpoint Support: Automatic discovery and fallback across API endpoints
• Binary Data Handling: Native support for Pi-hole's teleporter backup format
• Error Recovery: Comprehensive error handling with detailed debugging information

🛡️ Enhanced Security

• No SSH Dependencies: Eliminates SSH-related security concerns for web-only setups
• Session-Based Auth: Temporary authentication tokens that expire automatically
• Secure Credential Storage: Pi-hole admin passwords encrypted and never logged
• Network Isolation: Works within Docker networks without exposing additional ports

🎨 User Experience Improvements

• Setup Wizard Enhancement: New connection method selection with guided setup
• Real-Time Feedback: Live connection testing during configuration
• Comprehensive Validation: Automatic validation of Pi-hole URLs and credentials
• Error Diagnostics: Detailed error messages with troubleshooting guidance

📈 Performance & Reliability

• Direct API Access: Faster backup operations without SSH overhead
• Automatic Retry Logic: Built-in retry mechanisms for network failures
• Concurrent Processing: Non-blocking API calls for better responsiveness
• Resource Efficient: Lower memory and CPU usage compared to SSH methods

🔄 Backward Compatibility

• Existing Configurations: All existing SSH-based setups continue to work unchanged
• Seamless Migration: Easy upgrade path from SSH to web-only connections
• Legacy Support: Full support for older Pi-hole installations via API fallbacks
• Configuration Preservation: No breaking changes to existing config files

This release represents the most significant advancement in PiHoleVault's capability, opening up backup functionality to the entire Docker Pi-hole ecosystem while maintaining full compatibility with traditional installations.

---

Full Changelog: View all changes

PiHoleVault v1.6.1

🚀 PiHoleVault v1.6.1

Automatically generated release from version file update.

Changes

• Updated to version 1.6.1
• See commit history for detailed changes

Full Changelog: View all changes