A comprehensive, automated toolkit for creating multi-boot USB recovery drives using Ventoy. Perfect for system administrators, Linux enthusiasts, and anyone who needs reliable system recovery tools.
Need to recover a damaged Linux system RIGHT NOW? You don't need to set up the full Ventoy USB!
- Boot from any Ubuntu/Debian Live USB
- Open a terminal and clone this repository:
git clone https://github.com/yourusername/ventoy_linux_recovery_helper.git cd VLRH - Run the quick recovery wrapper:
sudo ./quick-recovery.sh
This will:
- Install any missing dependencies (like cryptsetup for encrypted systems)
- Run a diagnostic test to show your system layout
- Launch the recovery process
If you prefer to run the recovery directly:
sudo ./auto-recovery.sh- ✅ Encrypted System Support - Automatically detects and unlocks LUKS encrypted partitions
- ✅ Smart Partition Detection - Distinguishes between root, boot, and EFI partitions
- ✅ Filesystem Repair - Runs fsck on unmounted partitions
- ✅ Package Management - Fixes broken packages and dependencies
- ✅ Boot Repair - Rebuilds initramfs and updates GRUB
- ✅ System Analysis - Shows failed services and recent errors
- ✅ Manual Override - Option to manually select partitions if auto-detect fails
- 🔄 Resumable Downloads - Never re-download ISOs
- 🎯 Smart Recovery - Automated system repair with one command
- 📱 File Sharing - LocalSend integration for wireless transfers
- 🖥️ Multi-OS Support - Ubuntu LTS/Current + Debian Stable/Testing
- ⚡ One-Click Setup - Fully automated Ventoy installation
- 🔧 Comprehensive Tools - Filesystem repair, GRUB fix, package management
- Ubuntu 24.04.2 LTS (Noble Numbat) - 5 year support until 2029
- Ubuntu 24.10 (Oracular Oriole) - Current release
- Ubuntu 25.04 (Plucky Puffin) - Latest release
- Debian 12.11 (Bookworm) - Current stable
- Debian 13 (Trixie) - Testing/next release
auto-recovery.sh- Automated system repair (filesystem, GRUB, packages)install-localsend.sh- Cross-platform file sharingmaster-recovery.sh- Interactive recovery menu- Smart partition detection and mounting
git clone https://github.com/zudsniper/VLRH.git
cd ventoy_linux_recovery_helper
# Download ISOs (resumable)
./download-isos.sh
# Install to USB drive (will detect your drive)
sudo ./setup-ventoy.sh- Boot from your Ventoy USB
- Select any Linux ISO from the menu
- In the live environment:
sudo mount /dev/sda1 /mnt
cd /mnt/recovery_scripts
sudo ./master-recovery.sh- USB Drive: 32GB+ (64GB recommended)
- Target Systems: x86_64 (AMD64) architecture
- Network: Required for downloads and some recovery operations
- Host OS: Linux with bash, wget, curl
| Component | Size | Purpose |
|---|---|---|
| Ubuntu 24.04.2 LTS | ~6.0GB | Primary recovery OS |
| Ubuntu 24.10 | ~5.3GB | Current release |
| Ubuntu 25.04 | ~5.9GB | Latest features |
| Debian 12.11 | ~3.3GB | Stable alternative |
| Debian 13 (testing) | ~810MB | Next-gen tools |
| Recovery scripts | ~1MB | Automation tools |
| Total | ~21.3GB | Fits on 32GB+ USB |
./download-isos.sh # Automatically resumes from where it stopped
# OR
./resume-downloads.sh # Quick alias# Mount broken system
sudo mkdir -p /mnt/recovery
sudo mount /dev/[root-partition] /mnt/recovery
sudo mount --bind /dev /mnt/recovery/dev
sudo mount --bind /proc /mnt/recovery/proc
sudo mount --bind /sys /mnt/recovery/sys
# Enter system
sudo chroot /mnt/recovery
# Fix issues
update-grub
update-initramfs -u
apt --fix-broken installsudo mount /dev/sda1 /mnt && cd /mnt/recovery_scripts && sudo ./auto-recovery.sh| Problem | Solution |
|---|---|
| Won't boot / GRUB error | Auto-recovery fixes GRUB automatically |
| Package conflicts | dpkg --configure -a + apt --fix-broken install |
| Kernel panic | Rebuild initramfs and update GRUB |
| File system corruption | Automated fsck repair |
| Need files from broken system | Mount + LocalSend for wireless transfer |
cd ventoy_linux_recovery_helper
git pull # Get latest scripts
./download-isos.sh # Download new ISOs
sudo ./setup-ventoy.sh # Reinstall to USBventoy_linux_recovery_helper/
├── download-isos.sh # Resumable ISO downloader
├── setup-ventoy.sh # Complete Ventoy installation
├── auto-recovery.sh # Automated system repair
├── install-localsend.sh # File sharing setup
├── resume-downloads.sh # Quick resume alias
├── README.md # This file
├── LICENSE # MIT License
└── .gitignore # Git ignore rules
Contributions welcome! Please read our contributing guidelines:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Additional Linux distributions
- More recovery automation
- Hardware-specific fixes
- Documentation improvements
- Testing on different systems
- Add more Linux distributions (Fedora, openSUSE, etc.)
- Windows PE recovery tools integration
- Automated hardware diagnostics
- Cloud backup integration
- Web-based recovery interface
- Support for ARM64 systems
This toolkit will completely erase your target USB drive. Always backup important data before running the setup script. Use at your own risk - while extensively tested, system recovery operations can potentially cause data loss if used incorrectly.
This project is licensed under the MIT License - see the LICENSE file for details.
- Ventoy Team for the amazing multi-boot solution
- Ubuntu and Debian communities
- LocalSend for cross-platform file sharing
- All contributors and testers
Made with ❤️ for the Linux community
Star ⭐ this repo if it helped you recover a system!