HOW-TO:Install Kodi for Linux

From Kodi
Jump to: navigation, search
Home icon grey.png   ▶ Installing
▶ Linux
▶ HOW-TO:Install Kodi for Linux

These are instructions for people who already have a Linux-based OS setup, or wish to do their own installation of Linux. Alternatively you can try out XBMCbuntu, which will install both an OS and XBMC/Kodi with an easy installer.

Attention.png NOTICE:
See Migration from XBMC to Kodi for special notes about going from an older XBMC version to Kodi.


1 Official Team Kodi repositories

1.1 Ubuntu

Simple Install Instructions
Note: Click here to find out how to use the terminal.

Use the command line terminal and enter the following commands. Follow the prompts as you would any other software installation.

sudo apt-get install python-software-properties pkg-config
sudo apt-get install software-properties-common
sudo add-apt-repository ppa:team-xbmc/ppa
sudo apt-get update
sudo apt-get install kodi

The XBMC repositories are as follows: ppa:team-xbmc/ppa Final release builds ppa:team-xbmc/unstable Betas and release candidates ppa:team-xbmc/xbmc-nightly Nightly builds

1.1.1 Upgrading

To update XBMC/Kodi when a new version is released, just do a general system/package or use the following commands in the terminal (or via SSH):

sudo apt-get update
sudo apt-get upgrade

1.1.2 KodiBuntu

XBMCbuntu is a combination XBMC/operating system for use on PCs that are mainly just running XBMC. It is an alternative to installing Windows or a larger (and sometimes more complicated) Linux-based OS.

1.1.3 Installing a development build

To install a beta/unstable version of XBMC/Kodi you must first add the unstable repository, then install XBMC:

Use ppa:team-xbmc/xbmc-nightly for nightly builds and ppa:team-xbmc/unstable for beta builds.

sudo add-apt-repository ppa:team-xbmc/xbmc-nightly
sudo apt-get update
sudo apt-get install kodi

Follow the prompts to add the repository, then to add the updates, and finally install the new version of Kodi.

1.1.4 Going back to a stable version from a development version

To return to a stable release:

Find the current PPA you are using:

sudo apt-cache policy | grep team-xbmc

Remove the unstable or nightly PPA where it says PPAHERE:

sudo add-apt-repository -r ppa:PPAHERE

Then restore the stable version with the following commands:

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

1.1.5 Downgrading

Note: If you have existing settings then they probably won't migrate well to the older version. Especially add-ons and library data. It is recommended that you start fresh (delete the userdata folder and parent .kodi/.xbmc folder) or restore from a backup that works with the older version you are installing.

Use these commands if you need to downgrade. For example, from Kodi v14 to XBMC v13.2:

sudo apt-get update
sudo apt-get install xbmc=2:13.2* xbmc-bin=2:13.2*

Note the version number after "xbmc=2:". For older Kodi versions replace "xbmc" with "kodi" for both xbmc and xbmc-bin.

For a full list of available versions type in this command:

sudo apt-cache policy xbmc


sudo apt-cache policy kodi

1.1.6 Uninstalling

If you need to remove and purge an application and finally removing/purging also the application configurations files, do so by using the following commands:

sudo apt-get update
sudo apt-get remove kodi*
sudo apt-get purge kodi*

Then remove the settings folder to remove all settings and library data. This will not delete any videos or music, but just the settings and library data itself:

rm ~/.kodi/


rm ~/.xbmc/ # for older versions before 14.0

2 Other repositories

Unofficial Linux binaries that are un/semi supported by Team Kodi. Most of those binaries use system ffmpeg or even worse totally untested libav, which is not recommended for XBMC/Kodi as we support ffmpeg only.

2.1 Debian

2.2 Fedora

Refer to HOW-TO:Install Kodi on Fedora 21 using RPMFusion packages for a guide showing how to install Fedora 21 and Kodi to create a quick-booting, standalone style of media player.

FedoraProject also has this page discussing how to build a dedicated home theatre.

2.3 OpenELEC

OpenELEC (short for "Open Embedded Linux Entertainment Center") is a free and open source, small and very fast booting, embedded operating system. OpenELEC is a complete media center software suite that comes with a pre-configured version of XBMC/Kodi and third-party add-ons with retro video game console emulators and PVR plugins.

3 Installation from source

If distribution packages are not available, or you need a newer version, or specific features enabled, then you will most likely need to compile from source. While compiling from source does not differ very much between distributions (except for installation of build dependencies), a few different guides are available in this wiki.

4 See also

Personal tools

Wiki help