What problem does it solve?
Recover from interrupted package operations, half-configured dpkg state, broken dependencies, and APT lock contention that prevent installs or upgrades from finishing.
Core Features & Use Cases
- Diagnose package health and dependency consistency to determine repair scope.
- Finish pending dpkg configuration, run solver-driven fixes for broken dependencies, retry missing downloads for specific packages, and inspect lock owners without blindly removing lock files.
- Use cases include interrupted CI/CD installs, failed local .deb installs, cloud image provisioning that was interrupted, and agents needing to restore package manager health before continuing other tasks.
Quick Start
Run the repair script with an action like check to diagnose package health by setting APT_REPAIR_ACTION=check and executing the scripts/repair-apt.sh script.