Broken Packages / Unmet Dependencies
Raspberry Pi Single-Board Computer
Severity: ModerateWhat Does This Error Mean?
Broken packages means some installed software has unmet dependencies — files it needs are missing or the wrong version. This usually happens after a partial update or interrupted install. Run sudo apt --fix-broken install to repair.
Affected Models
- Raspberry Pi 5
- Raspberry Pi 4B
- Raspberry Pi 3B+
- All Raspberry Pi models running Raspberry Pi OS
Common Causes
- Update interrupted (power loss, Ctrl+C during apt upgrade)
- Manually installed .deb package with missing dependencies
- Repository changed or package removed from repository
- Mixing repositories from different Debian versions
- SD card corruption during package write
How to Fix It
-
Run: sudo apt --fix-broken install
This attempts to fix broken dependencies by installing missing packages or removing broken ones.
-
Then run: sudo apt update && sudo apt upgrade
Update the package list and upgrade all packages to the latest versions.
-
If that fails: sudo dpkg --configure -a
This finishes configuring any packages that were interrupted mid-install.
-
As a last resort: sudo apt clean && sudo apt autoremove
This clears the package cache and removes orphaned packages.
Frequently Asked Questions
Can broken packages damage my Pi?
No hardware damage. But broken packages can make software unusable. The fix commands above resolve most cases.
Should I avoid interrupting apt?
Yes. Never power off or Ctrl+C during apt install or upgrade. Interrupted installs are the most common cause of broken packages.