dpkg Command: Tutorial & Examples

Install, remove, and manage Debian package files

dpkg is a package management system for Debian and Debian-based Linux distributions such as Ubuntu, Linux Mint, and Raspbian. It is used to install, remove, and manage software packages in the .deb format. Understanding how to use dpkg effectively is essential for system administrators and users of these distributions.

How dpkg works

dpkg operates at a low level, managing .deb files directly. It does not resolve dependencies automatically, meaning that if a package requires other packages to function, you must install these manually first. This is a crucial distinction from higher-level package management tools like apt and apt-get.

When you execute a command with dpkg, it directly interacts with the filesystem and maintains a database of installed packages, typically located in /var/lib/dpkg/.

What dpkg does

dpkg performs several key functions:

  • Installation of packages: Allows users to install new software from .deb files.
  • Removal of packages: Can remove installed packages and their associated files.
  • Querying installed packages: Users can check the status, version, and other details of installed packages.

Common command line parameters

Here are some common parameters used with the dpkg command:

  • -i: Install a package from a .deb file.
  • -r: Remove an installed package.
  • -l: List all installed packages.
  • -S: Search for a package that owns a specific file.
  • -s: Get information about a specific installed package.

Examples of usage

To illustrate how to use dpkg, here are several examples:

To install a package:

dpkg -i package_name.deb

Expected output if successful:

Selecting previously unselected package package_name.
(Reading database ... 123456 files and directories currently installed.)
Preparing to unpack package_name.deb ...
Unpacking package_name (1.0-1) ...
Setting up package_name (1.0-1) ...

To remove a package:

dpkg -r package_name

Expected output if successful:

(Reading database ... 123456 files and directories currently installed.)
Removing package_name (1.0-1) ...
Purging configuration files for package_name (1.0-1) ...

To list all installed packages:

dpkg -l

Expected output:

ii  package_name         1.0-1   Description of package_name

To search for a package that owns a specific file:

dpkg -S /path/to/file

Expected output:

package_name: /path/to/file

To get detailed information about an installed package:

dpkg -s package_name

Expected output:

Package: package_name
Status: install ok installed
Priority: optional
Section: utils
Installed-Size: 1234
Maintainer: Your Name <your.email@example.com>
Architecture: amd64
Version: 1.0-1
...

Potential problems and pitfalls

Using dpkg can lead to several common issues:

  • Dependency problems: If a package requires other packages to function and they are not installed, dpkg will not handle this. It is essential to resolve dependencies manually or use a higher-level tool like apt.

  • Orphaned packages: dpkg does not automatically remove packages that are no longer needed, which can lead to clutter on your system. You might need to use apt autoremove to clean up.

Real-world use cases

dpkg is often used in scenarios where:

  • You need to install a package not available in a repository.
  • You are managing a system without an internet connection and have .deb files available locally.
  • You want to perform low-level package management tasks for troubleshooting or debugging.

Troubleshooting common errors

When using dpkg, you may encounter errors such as:

  • Package not found: This occurs if the specified package name is incorrect or the .deb file is not in the current directory. You can check your current directory using pwd.

  • Dependency errors: If a package requires other packages that are missing, you can resolve this by installing the necessary dependencies manually.

  • Broken packages: You can fix broken packages using:

    dpkg --configure -a

Security considerations

When installing packages with dpkg, ensure you trust the source of the .deb files to avoid security risks. Installing from untrusted sources can compromise system security. Always verify the integrity of packages using checksums or signatures when available.

See also

Further Reading

As an Amazon Associate, I earn from qualifying purchases.

The text above is licensed under CC BY-SA 4.0 CC BY SA