From Official Kodi Wiki
Jump to navigation Jump to search

This page or section has not been updated in a long time, no longer applies, refers to features that have been replaced/removed, and/or may not be reliable.

This page is only kept for historical reasons, or in case someone wants to try updating it.

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

Hardware requirements

Kodibuntu should work with the general hardware requirements for Linux:


Kodibuntu comes in an ISO form that can be written to a USB drive or burned to an optical disc.

Download the current stable Kodibuntu image from:

The Complete installation guide can be found here: Kodi Linux - The Complete Guide


  • Kodibuntu has only one iso image file for all x86 computers, regardless of GPU.
  • Currently, only a 64-bit version is available, but this should cover the vast majority of users.
  • A pre release 32bit exists in mirrors with unstable ppa and RC candidate Kodi, which can be upgraded to stable kodi
  • There will be no separate Kodibuntu release for Kodi 15.x as it's based on the same OS. To get Kodi 15.x on Kodibuntu, just upgrade the software as suggested below


Current Kodibuntu is based on a LTS release (long term release) which is supported for 5 years, this means that it isn't required to upgrade the OS base in order to obtain updated or upgraded application packages.

How to upgrade Kodi

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

sudo apt update
sudo apt upgrade --with-new-pkgs

When to upgrade the OS

See Current Ubuntu releases if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.

Basic use

Desktop mode

Kodibuntu can boot directly into Kodi or it can also boot into a desktop mode for using applications such as a web browser.

In order to enter desktop mode, follow those steps below:

The username may differ from the one you supplied during installation. So please be aware, that "xbmc" (as shown in the screenshot) might not be the username you will see and/or have to use.

Note: If you last booted directly or switched to desktop and shutdown the HTPC while in desktop, on next reboot you will get the last used session by default.

To return to Kodi, logout, select Kodi as session in the top-right pulldown menu and enter your username and password again.


To login to the command line interface press Ctrl+Alt+F1 - F6 or connect over SSH by using usernamne and password supplied during installation.

Note: For the use of Ctrl+Alt+F1 - F6 no username and password is required. You are logged in directly to the command line.

Media center

Kodibuntu contains Kodi for Linux compiled with the 'standalone' mode, this enabled certain functions that are not available in normal Kodi installations (Windows, Mac Linux), these functions include Power Management, and Network Management.

Using desktop mode

Chromium is included for web browsing and can be found in the start menu.

In Systems / Package Manager tools - you can install other applications for your specific needs.

Other Uses

KodiBuntu VNC Server

  • Install x11vnc
  • Set password
    • x11vnc -storepasswd
  • Test connection by running manual start command.
x11vnc -auth guess -forever -loop -noxdamage -repeat -rfbauth /home/USERNAME/.vnc/passwd -rfbport 5900 -shared

Have x11vnc start automatically via upstart in any environment (<=Utopic)

sudo nano /etc/init/x11vnc.conf
# description "Start x11vnc at boot"
description "x11vnc"
start on runlevel [2345]
stop on runlevel [^2345]
console log
respawn limit 20 5
exec /usr/bin/x11vnc -auth guess -forever -loop -noxdamage -repeat -rfbauth /home/USERNAME/.vnc/passwd -rfbport 5900 -shared

See also