Fix Package Manager Issues
Here are ways to resolve installation, update, upgrade, and other package-related issues.
System-wide packages (APT/DPKG)
If your system complains about a failed upgrade, package manager conflicts, broken packages, or other package-related issues, there are several common fixes to these problems.
You can resolve some package manager issues with a graphical app, but many require the command line. If you see a red circle in the panel indicators, try opening the Terminal (Zorin Menu → Utilities → Terminal) and running these commands to fix the package manager:
sudo apt clean
sudo apt update
sudo dpkg --configure -a
sudo apt install -f
sudo apt full-upgrade
sudo apt autoremove --purge
What do these commands do?
This prefix runs the following command with administrator privileges. This is required when making changes to the system packages.
Clears out previously retrieved package files from the system’s local cache.
Fetches indexes from all configured sources. Other apt options use these indexes to determine which packages can be upgraded or installed.
dpkg --configure -a
Configures any unpacked but not yet configured packages.
apt install -f
-foption attempts to correct broken dependencies
In addition to downloading and installing package updates, this downgrades or removes dependencies as necessary when upgrading packages.
apt autoremove --purge
Running this command with no specified package will remove any packages that were previously dependencies for other installed packages but are no longer required (either because the dependent package was removed, or because the package was updated to no longer depend on certain packages.)
Fix individual packages
Sometimes, you may see some packages that are still broken and need to be installed manually or purged manually. There may be broken dependencies or cyclical dependencies. If so, these commands can help:
Use this command to reinstall the package, replacing “package-name” with its correct name. This can be convenient when the package has many reverse dependencies:
sudo apt install --reinstall package-name
If that didn’t resolve the issue, you can use this command to remove the package and its system-wide configuration files:
sudo apt purge package-name
purgecommand. If the text output mentions that it will remove several additional packages besides the one you are trying to fix, don't run it! If it's only a few packages, it's most likely safe.
If additional packages are removed, make sure to install them again before restarting the computer. One of these commands will make sure the core Zorin OS components are installed after any purge commands:
- For non-Lite editions of Zorin OS:
sudo apt install zorin-os-desktop
- For Lite editions of Zorin OS:
sudo apt install zorin-os-lite-desktop
Reinstall the package with this command:
sudo apt install package-name
Remote repositories can’t be reached
If the Software Updater app or Terminal indicates that some remote repositories can’t be reached, you may have added a third-party software repository that is either configured incorrectly or is experiencing server errors. To resolve this issue, please follow these steps:
- Open the Zorin Menu → System Tools → Software Updater.
- After the Software Updater has finished checking for updates, click on “Settings…”.
- Navigate to the “Other Software” tab.
- Find the broken third-party repositories in the list.
- Search for the software vendor on the web to determine what has happened to their repository server.
- Either remove the repository from the list or edit its address. You may need to change the version codename of the repository (xenial, bionic, focal, etc.) to match the current version of the operating system. The correct version codename for Zorin OS 16 should be “focal”.
- Close the “Software & Updates” window and agree to “Reload” the package sources when prompted.
The Synaptic Package Manager app is a powerful graphical frontend for the APT package manager. You can install, remove, selectively upgrade, or pin packages and gain information about their purpose and dependencies. It also provides a comprehensive list of available packages and apps that you can download.
Learn more about the Synaptic Package Manager ›
If the Software store is showing available updates, but can’t install them after clicking the “Update All” button, there may be Flatpak runtimes (backend software that other Flatpak packages depend on) with updates available.
Open the Terminal and run these three commands to update all Flatpaks and remove any Flatpak runtimes that are no longer required by any installed app:
flatpak uninstall --unused
flatpak repair --user
Snaps usually update themselves as needed. However, if you would like to manually update the Snaps on your system, run these two commands:
snap refresh --list
sudo snap refresh
Run this command to remove a Snap package, replacing “package-name” with its correct name:
sudo snap remove package-name