From Official Kodi Wiki
Jump to navigation Jump to search
Return to:
Home icon grey.png   ▶ Video library ▶ Backup

1 Introduction

Like all technology, disaster can strike at any time, either due to a hardware failure, operating system crash which has corrupted Kodi data, or unexpected results from the use of a nightly or development build of Kodi. For these reasons, backups of Kodi are essential to enable you to quickly rebuild your setup.

There are many methods available to protect your data. The more common methods include manual copying of folders and files, Kodi backup add-on or popular 3rd party backup programs (not covered here).

This wiki page is not a step by step guide and requires that you have a general knowledge of computers and file systems. It will provide you information that will allow you to decide what to backup and which method to use.

This page relates to Kodi only. Your media files are external to Kodi and are not part of the backup described here.

2 Where Is Kodi Installed

Kodi installs itself in two locations.

2.1 Installation Folder

This location holds the core program files for Kodi and the location varies depending on which operating system in use.

The files in this location should not be touched as they are purely the program files. After the initial install, no add-ons, databases, caches or skins are installed here. There is no need to backup this section as you can simply download the latest version of Kodi and reinstall it.

2.2 Kodi Data Folder

Once Kodi is installed, all subsequent changes and usage data are saved in the Kodi data folder which is the parent folder of the Userdata folder. When you install a new skin or an add-on it is installed in this folder. Playlists and edits to Nodes are stored here, and the library databases are created here along with the artwork cache and any other changes you make during your travels with Kodi

Basically anything you add or modify, after installation, occurs in this folder and sub-folders.

The location of this folder varies between operating systems and the table below lists their locations.

Operating system Kodi Data folder path
Android Android/data/org.xbmc.kodi/files/.kodi
iOS /private/var/mobile/Library/Preferences/Kodi
LibreELEC /storage/.kodi
Linux ~/.kodi
Mac /Users/<your_user_name>/Library/Application Support/Kodi
Nvidia Shield (SMB) smb://<nvidiashieldurl>/internal/Android/data/org.xbmc.kodi/files/.kodi
OSMC /home/osmc/.kodi
tvOS /private/var/mobile/Library/Preferences/Kodi
Windows C:\Users\<YourUsername>\AppData\Roaming\Kodi
Windows Portable <Install location chosen by you>\portable_data
Windows Xbox %LOCALAPPDATA%\Packages\XBMCFoundation.Kodi_4n2hpmxwrvr6p\LocalCache\Roaming\Kodi\
Note: In some Android setups the path may be slightly different to the one stated above.

3 What do I Backup

The following sub-sections cover the most common backup scenarios.

3.1 Full

The simplest method is the full Kodi data folder backup which will backup everything in Kodi except the original installation folder. It will preserve all add-ons, skins, library databases, playlists, cache along with all their respective settings and any other modifications you have made in Kodi.

Once this backup is restored and Kodi is restarted, you should have a setup that is identical to the setup you had at the time the backup was created.


  1. Should not be used to transfer the Kodi data folder between different operating systems (eg Windows to Linux)
  2. Should not be used to transfer between different major versions of Kodi. Point releases are ok.
  3. When using this method to transfer to different hardware using the same operating system, be aware of the hardware and driver differences. eg different audio chip, different graphic card etc which will require adjusting some settings in Kodi
  4. Once this backup is installed Kodi will perform the usual Repository Update check and if there are updates available for any skins or add-ons, these will be downloaded and installed unless you have previously disabled auto-update.

3.2 Library

If your only concern is your artwork and library metadata, then using the Export function of Kodi will create backup files of the Music and/or Video libraries that can be quickly scanned back into Kodi.

For the Music Library we recommend using the Single File setting
For the Video Library we recommend using the Separate Files setting. Be aware of the required settings to import Play Counts, Watched Status and Last Played data.

See: Import Export Library

3.3 Other

You could also be more selective and backup certain components, but this will require advanced knowledge as cherry picking items may not always work as you may find that you have ommitted a critical file or add-on located in another folder. This is particularly true for skins that use multiple discrete skin helper add-ons which save data in their own location within the Kodi Data folder.

4 Backup Methods

Various methods that are available to backup your data.

4.1 Manual

This is a simple task if Kodi is installed on hardware that uses a full operating system such as Windows. Simply navigate to the Kodi Data folder and copy it to your backup location.

On other systems, you may need to connect via a network or install a 3rd party file manager downloded from the appropriate Store.

4.2 Add-ons

If you prefer an automated method, then the following backup add-on is available from the Official Kodi repsitory under Programs

Wiki Page- Add-on:Backup
Forum Thread- tid=129499

These add-ons have been created by the community and can be used to backup or sync your video watched status with online sites:

4.3 Backup Software

If you are using a general 3rd party backup program for your computer, ensure you add the Kodi Data folder as a location for back up.

5 OS Specific

Information specific to operating systems.

5.1 LibreELEC

If using LibreELEC, use the Backup and Restore options in the Settings page.

See: LibreELEC Backup

5.2 Windows

Multiple Kodi Data folders can be saved in the Windows \Roaming\ folder. Kodi will always use the folder named Kodi. See image.

Copy the ...\Kodi folder and paste it to your backup location.

To safeguard against hard drive failures, you should also keep a backup in a secondary location.

Return to top