Kodi remains one of the most flexible media-center applications available on Linux. It turns an ordinary Ubuntu desktop into a front end for local movies, TV shows, music, photos, live television, network shares, and supported add-ons. On Ubuntu 26.04 LTS, the practical choice is between the current upstream build from Flathub and Ubuntu’s own APT package from the universe repository. The old Team Kodi PPA is no longer maintained, so it should not be used for a fresh installation.

This guide covers both supported installation paths, first-run configuration, hardware acceleration, remote-control access, updates, cleanup, and the issues that tend to appear on real desktop systems. It assumes a standard Ubuntu 26.04 desktop installation with a user account that has sudo privileges.

Before You Install Kodi

Kodi is a graphical media-center application, not a headless streaming server. Installing it on Ubuntu Server will place the binaries on disk, but Kodi still needs a display server, audio stack, input devices, and an active graphical session before it can be useful. If the goal is to serve media to browsers, phones, smart TVs, or other clients, Jellyfin or Plex is usually the better fit. Kodi belongs on the machine physically connected to the TV, monitor, projector, or AV receiver.

Ubuntu 26.04 LTS, codenamed Resolute Raccoon, is a long-term-support release, which makes it a sensible base for a dedicated media PC. The operating system receives security and maintenance updates for years, while the media-center layer can be updated independently through Flatpak or APT.

Choose the Right Installation Method

There is no single “best” way to install Kodi. The right method depends on whether you prioritize the newest upstream release, clean system-package management, or custom build control.

The official Kodi documentation states that the Team Kodi PPA is not currently maintained, and it identifies Flatpak, building from source, or a distribution package as the available alternatives. On Ubuntu 26.04, the repository package is Kodi 21.3, while Flathub provides the current upstream stable build, which makes Flatpak the better option when release freshness matters.

Update the System First

Start with a clean package state. This reduces the chance of dependency conflicts and ensures that security fixes are applied before adding multimedia software.

sudo apt update
sudo apt upgrade -y
sudo apt autoremove -y

If the machine has been offline for a long time, reboot after a kernel or graphics-driver update:

sudo reboot

That may sound obvious, but it prevents a common support scenario: Kodi installs successfully, then fails to initialize video acceleration because the running kernel does not match the newly installed driver modules.

Install Kodi from Flathub

Flathub is the preferred route for most people installing Kodi on Ubuntu 26.04. It provides the current upstream release, bundles its runtime dependencies, and avoids mixing Kodi’s multimedia libraries with the wider system package set. The official Kodi wiki points Linux users to Flathub for the packaged upstream build.

Install Flatpak

Ubuntu does not enable Flatpak by default. Install it first:

sudo apt install -y flatpak

Add the Flathub repository at system scope:

sudo flatpak remote-add --if-not-exists flathub \
  https://dl.flathub.org/repo/flathub.flatpakrepo

Confirm that the remote was added:

flatpak remotes --columns=name,options

You should see flathub listed with the system installation scope.

Install Kodi

Install the official Kodi Flatpak:

sudo flatpak install flathub tv.kodi.Kodi -y

Verify the installation:

flatpak info tv.kodi.Kodi

A healthy installation should report the application ID tv.kodi.Kodi, the stable branch, and the current upstream Kodi version.

Launch Kodi

Launch it from the terminal:

flatpak run tv.kodi.Kodi

Or open Activities, search for Kodi, and start it from the application menu. The Flatpak package also appears in the desktop launcher after installation.

Understand Flatpak Data Locations

The Flatpak version stores its profile, databases, add-ons, thumbnails, and settings here:

~/.var/app/tv.kodi.Kodi

That separation is useful. Removing or reinstalling the Flatpak application does not automatically destroy your Kodi library configuration, though you should still back up the directory before major version changes or channel switches. The official Kodi wiki specifically recommends backing up that location before changing release channels.

Install Kodi from Ubuntu Repositories

The APT method is ideal when you want Kodi managed exactly like the rest of the system. Updates arrive through Ubuntu’s package management workflow, removal is predictable, and there is no additional runtime layer to maintain.

Enable the Universe Repository

Kodi is distributed through Ubuntu’s universe component. On a standard desktop installation, it is usually already enabled. On a minimal, customized, or server-derived installation, check the active repositories:

grep -RhsE '^deb .*universe' /etc/apt/sources.list /etc/apt/sources.list.d/

If universe is missing, enable it with:

sudo add-apt-repository universe
sudo apt update

Install the APT Package

Install Kodi with:

sudo apt install -y kodi

Check which version APT selected:

apt-cache policy kodi

On Ubuntu 26.04, the package is currently in the Kodi 21.3 series. The exact package string may change as Ubuntu publishes maintenance updates, but the command will show both the installed and candidate versions.

Verify the Installation

Confirm the launcher and version:

command -v kodi
kodi --version

Ubuntu’s package is derived from Debian packaging, so the version output may identify itself as “Kodi from Debian.” That is normal and does not mean you installed the wrong application.

Launch Kodi with:

kodi

Configure Kodi After Installation

A fresh Kodi installation is intentionally empty. The interface is ready, but it has no media sources, no library metadata, and no remote-control configuration. Set those basics before importing a large collection.

Add Local Media Folders

Go to Videos → Files → Add videos and select the folder containing your media. Choose the correct content type, such as Movies or TV shows, so Kodi applies the appropriate scraper and library structure.

Consistent filenames save hours of cleanup later:

Movies/
  Dune (2021)/Dune (2021).mkv
  Arrival (2016)/Arrival (2016).mkv

TV Shows/
  The Expanse/
    Season 01/
      The Expanse S01E01.mkv
      The Expanse S01E02.mkv

For network storage, add an NFS, SMB, or WebDAV source through Kodi’s file browser. If the share contains sensitive material, mount it with restricted permissions rather than giving Kodi broad access to the entire filesystem.

Configure Audio Output

Open Settings → System → Audio and select the correct output device. On a desktop with speakers, this may be the default PulseAudio or PipeWire device. On an HTPC connected to an AV receiver, select the HDMI output and enable passthrough only for audio formats the receiver genuinely supports.

A practical rule: enable Dolby Digital or DTS passthrough only after confirming the receiver supports it. Otherwise, you may get silence, distorted audio, or a receiver that refuses to switch input modes.

Enable Hardware Video Acceleration

Hardware acceleration reduces CPU load, lowers power consumption, and prevents stutter during high-bitrate 4K playback. The exact option depends on the GPU and driver.

For Intel and AMD systems using VA-API, verify that the user has access to the render and video device groups:

groups "$USER"

If video or render is missing, add the user to the relevant groups:

sudo usermod -aG video,render "$USER"

Log out and back in for group membership to take effect. The Kodi documentation notes that proper group membership helps ensure VA-API initializes correctly on Intel and AMD systems.

Check GPU and OpenGL status with:

sudo apt install -y mesa-utils
glxinfo | grep "OpenGL version"

A working desktop GPU should return an OpenGL version string. If it does not, fix the graphics driver before troubleshooting Kodi playback.

Set Up Kodi Remote Control

Kodi can be controlled from a phone, tablet, browser, or another device on the local network. This is convenient for an HTPC, but it should never be exposed carelessly.

Open Settings → Services → Control and enable the HTTP remote-control interface. Set a strong username and password before allowing external connections. Kodi’s default web interface listens on port 8080.

Restrict Access with UFW

If UFW is not installed or enabled, set it up first:

sudo apt install -y ufw
sudo ufw enable

Allow the web interface only from your local network. Replace the subnet with your actual LAN range:

sudo ufw allow from 192.168.1.0/24 to any port 8080 proto tcp

Review the active rules:

sudo ufw status numbered

Do not open port 8080 to the public internet unless you fully understand the exposure. Kodi’s web interface is designed for local-network control, not as an internet-facing service. A home router firewall should block unsolicited inbound traffic by default.

Install Useful Kodi Add-ons

Kodi’s core value comes from its add-on ecosystem. Use the built-in Add-ons → Download menu rather than installing random ZIP files from unknown websites.

Common legitimate add-on categories include:

• Subtitle providers for movies and television.
• PVR clients for supported live-TV backends.
• Weather, visualization, and interface enhancements.
• Music and image library integrations.
• Official or well-known third-party services.

Avoid repositories that promise free access to premium streaming services. Besides the legal risk, unofficial add-ons are a frequent source of broken updates, excessive network calls, and poor system stability. On a media PC, stability is the feature users notice most.

Performance Tuning for a Kodi HTPC

A Kodi system does not need to be powerful, but it does need to be predictable. The difference between a smooth media center and an annoying one is rarely raw CPU speed. It is usually disk latency, graphics drivers, thermal throttling, or background services competing for resources.

Use an SSD for the System Disk

Put Ubuntu and the Kodi profile on an SSD. Media files can remain on a larger HDD or NAS, but the operating system, database, thumbnails, and application files benefit greatly from low-latency storage.

A typical layout looks like this:

SSD: Ubuntu, Kodi profile, cache, application data
HDD or NAS: Movies, TV shows, music, photos

This arrangement keeps library browsing responsive even when the media storage is busy.

Keep the Desktop Lightweight

For a dedicated HTPC, avoid heavyweight desktop environments and unnecessary background applications. GNOME works, but a lighter session can reduce memory use and improve boot time.

Useful checks include:

free -h
df -h
systemd-analyze blame | head

Disable services you do not need, but do so deliberately. For example, if the system has no printer:

systemctl status cups

If it is unnecessary, disable it:

sudo systemctl disable --now cups

Do not blindly disable audio, Bluetooth, NetworkManager, or display-related services. Those are often essential on a media PC.

Manage Cache and Thumbnails

Large libraries can consume substantial disk space through artwork, fanart, and cached metadata. Check the Kodi profile size:

du -sh ~/.kodi

For a Flatpak installation:

du -sh ~/.var/app/tv.kodi.Kodi

If thumbnails and cached artwork grow excessively, clean unused library entries from inside Kodi rather than deleting database files manually. Manual deletion can break watched-state data, library links, and add-on settings.

Monitor Playback Issues

When playback stutters, identify whether the bottleneck is CPU, disk, network, or GPU:

htop
iostat -xz 2

If iostat is unavailable, install the package:

sudo apt install -y sysstat

High %util on the media disk during playback suggests slow storage or a poorly optimized network share. High CPU use during video playback often points to missing hardware acceleration or an unsupported codec. High memory use may indicate an add-on problem rather than Kodi itself.

Updating Kodi on Ubuntu 26.04

Use the package manager that installed Kodi. Mixing update mechanisms creates confusion and can leave duplicate desktop entries or incompatible profiles.

Update the Flatpak Build

sudo flatpak update tv.kodi.Kodi -y

To update all Flatpak applications and runtimes:

sudo flatpak update -y

Update the APT Build

sudo apt update
sudo apt install --only-upgrade kodi kodi-bin kodi-data \
  kodi-repository-kodi kodi-visualization-spectrum

APT will not move an older Ubuntu LTS to a newer upstream Kodi branch unless Ubuntu publishes that branch for that release. That is not a defect; it is how distribution-managed packages maintain compatibility. If current-release features matter more than distro-managed packages, use Flathub.

Troubleshooting Common Kodi Problems

Most Kodi issues on Ubuntu fall into a handful of categories: stale repositories, graphics initialization, audio routing, permissions, and add-on failures. Start with logs before changing settings at random.

Kodi Will Not Launch

Run Kodi from a terminal using the command that matches your installation method:

flatpak run tv.kodi.Kodi

or:

kodi

The first error message is usually more useful than repeatedly clicking the desktop icon. If the version check works but the graphical interface does not appear, verify that you are in an active graphical session and that the GPU driver is functioning.

Check OpenGL:

glxinfo | grep "OpenGL version"

If glxinfo is missing:

sudo apt install -y mesa-utils

Fix an Old or Broken Team Kodi PPA

Older guides still recommend ppa:team-xbmc/ppa. Do not add it on Ubuntu 26.04. The Kodi project states that the PPA is not currently maintained, and stale PPA entries can cause update errors or dependency conflicts.

Remove it if it exists:

sudo add-apt-repository --remove ppa:team-xbmc/ppa
sudo apt update

If unstable or nightly repositories were added previously, remove those too:

sudo add-apt-repository --remove ppa:team-xbmc/unstable
sudo add-apt-repository --remove ppa:team-xbmc/xbmc-nightly
sudo apt update

Fix Missing Library Errors

Errors involving libspdlog, fmt, or other shared libraries usually indicate a mismatched binary, an abandoned PPA package, or a broken source build. Do not create manual symlinks between incompatible library versions. That may make one error disappear while creating subtler runtime failures.

Remove the broken APT installation:

sudo apt remove --purge kodi kodi-bin
sudo apt autoremove

Then reinstall from Ubuntu’s repository:

sudo apt install -y kodi

Or install the Flathub build:

sudo flatpak install flathub tv.kodi.Kodi -y

The official Kodi guidance similarly advises removing mismatched packages rather than attempting library-level workarounds.

Fix Video Stutter or High CPU Usage

Check whether hardware acceleration is active:

sudo apt install -y intel-media-va-driver mesa-utils
vainfo

On NVIDIA systems, ensure the proprietary driver is installed and active:

ubuntu-drivers devices

Then confirm the correct driver is selected:

sudo ubuntu-drivers install

Reboot afterward:

sudo reboot

If CPU use remains high, test the same file with a lower-demand output setting, disable unnecessary visualizations, and check whether an add-on is scanning or transcoding in the background.

Fix No Sound or Wrong Audio Device

Open Settings → System → Audio and cycle through available output devices. On HDMI systems, the receiver or television may expose several audio endpoints.

If PulseAudio or PipeWire is not running, inspect it with:

systemctl --user status pipewire pipewire-pulse wireplumber

Avoid changing system-wide audio configuration until you have confirmed the problem is not simply a wrong Kodi output device.

Reset Kodi Without Deleting Media

If Kodi becomes unstable, back up the profile first:

tar -cJf "$HOME/kodi-backup-$(date +%F-%H%M).tar.xz" -C "$HOME" .kodi

Then remove the profile:

rm -rf ~/.kodi

For the Flatpak version:

rm -rf ~/.var/app/tv.kodi.Kodi

This removes Kodi settings, add-on configuration, databases, watched status, and cached artwork. It does not delete your movies, music, or photos stored elsewhere. The official Kodi documentation recommends backing up the profile before removing it during troubleshooting.