How to Install .deb Packages on Ubuntu 26.04

Installing software on Ubuntu 26.04 typically involves the APT package manager pulling packages from official repositories. However, there are times when you need to install a .deb package file directly, whether it is a proprietary application from a vendor’s website, a locally built package, or software not available in the default repositories. This guide covers every method to install .deb packages on Ubuntu 26.04 Resolute Raccoon, including dependency resolution and troubleshooting.

In this tutorial you will learn:

  • What a .deb package is and when you need to install one manually
  • How to install .deb files using apt with automatic dependency resolution
  • How to use dpkg for low-level .deb package installation
  • How to install .deb packages graphically with GDebi
  • How to verify, list, and remove packages installed from .deb files
  • How to troubleshoot common .deb installation errors
Abstract illustration representing .deb package installation on Ubuntu Linux with package archive and terminal elements
Installing .deb packages on Ubuntu 26.04 using apt, dpkg, and GDebi

Software Requirements

Software Requirements and Linux Command Line Conventions
Category Requirements, Conventions or Software Version Used
System Ubuntu 26.04 Resolute Raccoon
Software APT 3.1, dpkg (pre-installed), GDebi (optional)
Other Privileged access to your Linux system as root or via the sudo command.
Conventions # – requires given linux commands to be executed with root privileges either directly as a root user or by use of sudo command
$ – requires given linux commands to be executed as a regular non-privileged user

PREREQUISITE
This tutorial assumes you are familiar with APT package management on Ubuntu 26.04. Refer to that guide for foundational knowledge of how APT handles packages and repositories.

TL;DR
The recommended way to install a .deb package on Ubuntu 26.04 is with apt install ./package.deb, which automatically resolves dependencies. Use dpkg -i for low-level control, or install GDebi for a graphical option.

Quick Steps to Install a .deb Package
Step Command/Action
1. Install with apt (preferred) $ sudo apt install ./linuxconfig-hello_1.0_all.deb
2. Or install with dpkg $ sudo dpkg -i linuxconfig-hello_1.0_all.deb
3. Fix missing dependencies $ sudo apt --fix-broken install

What Is a .deb Package?

A .deb file is the Debian package format used by Ubuntu and all Debian-based distributions. Each .deb file is an archive that contains the compiled application binaries, configuration files, documentation, and metadata describing the package’s dependencies, version, and maintainer information.

Most of the time, you install software through APT and the official Ubuntu repositories. However, you may need to install a standalone .deb file in several situations:

  • The software vendor distributes their application as a .deb download (for example, Google Chrome, Visual Studio Code, or Zoom).
  • You have built a package locally from source.
  • You need a specific version of a package that is not available in the current repositories.
  • You are installing software on a system without internet access using previously downloaded packages.

Regardless of the reason, Ubuntu 26.04 provides several tools to handle .deb package installation, each with different strengths.

SANDBOX PACKAGE
Throughout this tutorial we use a custom sandbox package called linuxconfig-hello_1.0_all.deb to demonstrate each installation method. Replace this filename with the name of the .deb package you want to install on your system.

Installing .deb Packages with apt on Ubuntu 26.04

The apt install command is the preferred method for installing .deb packages on Ubuntu 26.04 because it automatically resolves and installs any missing dependencies from the configured repositories. This is the single most important advantage over using dpkg directly.

  1. Navigate to the directory containing the .deb file: Change to the directory where you downloaded the package. For most users this will be the ~/Downloads directory:
    $ cd ~/Downloads
  2. Install the .deb package with apt: Use apt install with the ./ prefix to indicate a local file path rather than a package name from the repository:
    $ sudo apt install ./linuxconfig-hello_1.0_all.deb

    The leading ./ is essential. Without it, APT interprets the argument as a package name to search for in the repositories rather than a local file.

  3. Verify the installation: Confirm the package was installed correctly by running the newly installed command:
    $ linuxconfig-hello
    Greetings from LinuxConfig.org!

    You can also check the package status:

    $ apt show linuxconfig-hello

APT will display a summary of the package to be installed along with any additional dependencies it needs to pull from the repositories. Review the list and confirm with Y when prompted. If a dependency cannot be satisfied from the configured repositories, APT will report an error and abort the installation cleanly without leaving the system in a broken state.

IMPORTANT
Always prefer apt install ./package.deb over dpkg -i when you have an active internet connection. APT handles the entire dependency chain in a single step, whereas dpkg requires manual dependency resolution.

Terminal showing apt install of linuxconfig-hello_1.0_all.deb on Ubuntu 26.04 with successful installation and greeting output
Installing the linuxconfig-hello .deb package using apt install and verifying with the linuxconfig-hello command

You may notice the following message at the end of the installation output:

Notice: Download is performed unsandboxed as root as file
'/home/linuxconfig/Downloads/linuxconfig-hello_1.0_all.deb' couldn't be
accessed by user '_apt'. - pkgAcquire::Run (13: Permission denied)

This notice is harmless. APT normally drops privileges to the unprivileged _apt user when processing packages as a security measure. When the .deb file resides in your home directory, the _apt user does not have permission to read it, so APT falls back to processing the file as root instead. The package still installs correctly. If you want to avoid the notice, move the .deb file to a world-readable location such as /tmp before installing:

$ sudo apt install /tmp/linuxconfig-hello_1.0_all.deb

Installing .deb Packages with dpkg

The dpkg command is the low-level package manager that underpins APT. While it can install .deb files directly, it does not resolve dependencies automatically. This makes dpkg useful in specific scenarios such as offline installations or when you need to force an installation, but it requires extra steps to handle missing dependencies.

  1. Install the .deb package with dpkg: Run the following command to install the package:
    $ sudo dpkg -i linuxconfig-hello_1.0_all.deb

    If all dependencies are already satisfied on your system, the installation will complete successfully.

  2. Resolve missing dependencies: If dpkg reports unmet dependency errors, use APT to fetch and install the missing packages:
    $ sudo apt --fix-broken install

    This command reads the dependency information left by the failed dpkg installation and downloads the required packages from the repositories. Once the dependencies are satisfied, it completes the installation of your original package as well.

  3. Verify the package is installed:
    $ dpkg -l | grep linuxconfig-hello

    A status of ii in the first column confirms the package is fully installed and configured.

    Terminal showing dpkg -i installation of linuxconfig-hello_1.0_all.deb on Ubuntu 26.04 with verification using dpkg -l
    Installing the linuxconfig-hello .deb package using dpkg -i and verifying with dpkg -l and linuxconfig-hello command

Installing Multiple .deb Files at Once

If you have several .deb files to install, you can pass them all to dpkg in a single command:

$ sudo dpkg -i package1.deb package2.deb package3.deb

Alternatively, install all .deb files in a directory:

$ sudo dpkg -i /path/to/debs/*.deb

Follow up with sudo apt --fix-broken install to resolve any dependency issues across all packages.

Installing .deb Packages with GDebi

GDebi is a lightweight tool that combines the simplicity of a graphical interface with automatic dependency resolution. It is particularly useful for desktop users who prefer not to use the terminal. Additionally, GDebi provides a command-line interface through gdebi-core that serves as a convenient alternative to the dpkg plus apt --fix-broken workflow.

  1. Install GDebi: GDebi is not installed by default on Ubuntu 26.04. Install it from the repositories:
    $ sudo apt install gdebi-core

    This installs the command-line version. If you also want the graphical interface, install the full package:

    $ sudo apt install gdebi
  2. Install a .deb package using GDebi CLI: Use the gdebi command followed by the path to the .deb file:
    $ sudo gdebi linuxconfig-hello_1.0_all.deb

    GDebi will display the package description and list any required dependencies before asking for confirmation. It then downloads and installs the dependencies and the package in one step.

  3. Install a .deb package using GDebi GUI: If you installed the graphical version, you can right-click a .deb file in the file manager and select “Open With GDebi Package Installer.” The GDebi window shows the package details, dependencies, and an “Install Package” button.

    Terminal showing gdebi installation of linuxconfig-hello_1.0_all.deb on Ubuntu 26.04 with package description and confirmation prompt
    Installing the linuxconfig-hello .deb package using sudo gdebi and verifying with the linuxconfig-hello command

Verifying and Managing Installed .deb Packages

Once you have installed a .deb package, Ubuntu treats it the same as any package installed from the repositories. You can query, update, and remove it using standard tools.

Checking Package Information

To display detailed information about an installed package:

$ apt show linuxconfig-hello

To list all files installed by a package:

$ dpkg -L linuxconfig-hello

To check whether a specific file belongs to a package:

$ dpkg -S /usr/bin/linuxconfig-hello
Terminal showing apt show, dpkg -L, and dpkg -S commands to verify the linuxconfig-hello package on Ubuntu 26.04
Querying package details with apt show, listing installed files with dpkg -L, and checking file ownership with dpkg -S

Removing a Package

Remove a package while keeping its configuration files:

$ sudo apt remove linuxconfig-hello

Remove a package along with its configuration files:

$ sudo apt purge linuxconfig-hello

After removing a package, clean up any orphaned dependencies:

$ sudo apt autoremove
Terminal showing apt purge removing the linuxconfig-hello package on Ubuntu 26.04 and confirming removal
Purging the linuxconfig-hello package with apt purge and confirming the command is no longer available

Troubleshooting .deb Package Installation on Ubuntu 26.04

Dependency Errors

The most common issue when installing .deb packages is unmet dependencies. If dpkg -i fails with dependency errors, run:

$ sudo apt --fix-broken install

If the required dependencies are not available in your configured repositories, you may need to add the appropriate repository or download the dependency .deb files manually.

Architecture Mismatch

If you attempt to install a package built for a different architecture (for example, installing an i386 package on a pure amd64 system), dpkg will refuse the installation. First, verify the architecture of your system:

$ dpkg --print-architecture

If you need to install packages for a foreign architecture, enable multiarch support:

$ sudo dpkg --add-architecture i386
$ sudo apt update

Then retry the installation.

File Conflicts

If a new package attempts to overwrite a file owned by another package, dpkg will abort with an error. To investigate which package owns the conflicting file:

$ dpkg -S /path/to/conflicting/file

You may need to remove the conflicting package first, or if you are certain the overwrite is safe, you can force the installation:

$ sudo dpkg -i --force-overwrite linuxconfig-hello_1.0_all.deb

FORCE INSTALL WARNING
Use --force-overwrite and other dpkg force options with extreme caution. Overwriting files from other packages can break your system. Always verify the conflict before forcing an installation.

Permission Denied Errors

If you encounter permission denied errors during installation, ensure you are using sudo with the installation command. Package installation requires root privileges to write to system directories.

Conclusion

Installing .deb packages on Ubuntu 26.04 is straightforward once you understand the available tools. Use apt install ./package.deb as your default method for its automatic dependency handling. Fall back to dpkg -i when you need low-level control or are working offline, and pair it with apt --fix-broken install to resolve dependencies afterward. For desktop users, GDebi offers a convenient graphical alternative. Regardless of which method you choose, always verify the source of any .deb file before installing it, as packages from untrusted sources can compromise your system’s security.

Frequently Asked Questions

  1. What is the difference between apt install ./package.deb and dpkg -i package.deb? The key difference is dependency handling. The apt install ./package.deb command automatically downloads and installs any missing dependencies from the repositories, while dpkg -i installs only the specified package and fails if dependencies are missing. With dpkg, you must manually run sudo apt --fix-broken install afterward to resolve dependencies.
  2. Why does apt install require the ./ prefix for local .deb files? The ./ prefix tells APT that you are specifying a file path rather than a package name. Without it, APT searches the repository index for a package matching the given name. The ./ signals that the argument is a path to a local file in the current directory.
  3. Can I install a .deb package without an internet connection? Yes. Use dpkg -i package.deb for offline installation. However, if the package has dependencies that are not already installed on the system, you will need to provide those dependency .deb files as well and install them together. You can pre-download all dependencies on a connected system using apt download and then transfer them to the offline machine.
  4. Is it safe to install .deb packages from third-party websites? Only install .deb packages from sources you trust, such as official vendor download pages. Third-party .deb files are not reviewed by the Ubuntu security team and could contain malicious software. When possible, verify the package checksum or GPG signature provided by the vendor.
  5. How do I check which .deb packages I have installed manually? There is no built-in command that distinguishes manually installed .deb files from repository packages. However, packages installed from local .deb files that do not match any repository will appear with a status of local when you run apt list --installed. You can also check the APT history log at /var/log/apt/history.log for records of local installations.