Kodi Crashes On Startup? Fix Your Problems Here

Do you have an issue where Kodi crashes on startup, perhaps after a new upgrade, skin, build, or addon was installed? Read below for help on how to fix your problems!

August 3rd, 2019 Update: If you found this guide via Google Search, your issues with Kodi crashing are most likely due to TVDB site changes. Click here to read our TVDB crashing Kodi guide for details, fixes, and workarounds.


Are you finding that Kodi crashes on startup and won’t take you to the home screen? Commonly, this issue occurs the first time you restart Kodi after a new update to the software or after you install a new skin, build, or addon. Before we get into what the startup sequence means and how to fix Kodi crashing, always make sure the following bullet points are true:

  • You are running the latest version of Kodi.
  • Your box is Android 5 or better.
  • You’ve only installed addons from their official repositories (NO Superrepo!)


Next you must understand what the Kodi startup sequence does so that you know where to look the next time Kodi crashes on startup.

When Kodi starts up, one of the main things it does is loads user settings, skin, and addon information from a folder called userdata. Kodi is just an open source media software. The software itself has nothing to do with any skin, build, or addon. These are developed in python and made available to install. Therefore, Kodi doesn’t know HOW to break on startup. It is simply a shell that loads what you have installed on it.

The only reason Kodi crashes on startup is because the version of Kodi you have launched is not compatible with something you have installed yourself (addon, skin, or build).


Kodi Crashes On Startup Fix Guide

If you want to save yourself some time and troubleshooting effort, simply delete Kodi and download it fresh from the Google Play Store (Android), Windows App Store (Windows), or Kodi.tv official website. Install Kodi fresh and install the addons you actually use, one by one.

If you insist on getting your old Kodi setup back, you need to find what part of your current setup is no longer compatible with Kodi. To fix Kodi, try the following:

  1. Locate your userdata folder and move it somewhere away from your Kodi directory. The table below will help you find your userdata folder.
Operative system File path
Android Android/data/org.xbmc.kodi/files/.kodi/userdata/ (see note)
iOS /private/var/mobile/Library/Preferences/Kodi/userdata/
Linux ~/.kodi/userdata/
Mac /Users//Library/Application Support/Kodi/userdata/ (see note)
OpenELEC /storage/.kodi/userdata/
Windows Start – type %APPDATA%\kodi\userdata – press
  • With your userdata folder gone, start Kodi. Does it start properly? You’ve just confirmed that something in your userdata folder is the cause for Kodi keeps shutting down.
  • Move folders from your original userdata folder back into your new folder until you move the folder that causes Kodi to crash again.


When you move a folder in that causes Kodi to crash, that’s your problem addon, skin, or build! Try moving everything back into userdata except this folder. If everything works great, then avoid using this one extension. If Kodi crashes on startup still, follow the third bullet point above until you identify all problems.


Do you have more questions? Let us know on Twitter or Facebook if we can help you out!


Sign up for a premium Kodi VPN and access the internet unrestricted. We offer exclusive discounts for IPVanish and NordVPN, the highest respected VPNs in the Kodi community. Both of these VPNs have some great features for users:

Apps for Android, iOS, Mac, Linux & more
Zero Logs
Unlimited bandwidth
Tier 1 hardware (no speed slowdown)
Access to servers hundreds of VPN servers

Click here to learn more about Kodi VPN protection
About Ryan William

Ryan is a content writer and SEO specialist. He has interest in all things technology and has published over 2000 posts on the internet. At Kodi Tips, his focus is on hardware, software, crypto games, and how-to tutorials.

11 thoughts on “Kodi Crashes On Startup? Fix Your Problems Here”

  1. I uninstall Kodi 17.6 , delete all folders in every possible locations , also done a registry sweep and removed all the left over that has to do with kodi. did a new download and re-install of Kodi 17.6, again as before it is still crashing at startup. There is nothing added as it is a fresh start up so no builds, no skins, no addons.

  2. “The only reason Kodi crashes on startup is because the version of Kodi you have launched is not compatible with something you have installed yourself (addon, skin, or build).”

    I thought I’d just add that this is NOT TRUE. The problems I’ve been having have been with the Kodi player. I cleared teh cache and data and forced a stop, and everything was fine (although I lost an addon). Now things are freezing up COMPLETELY after startup, and I know as a fact that I haven’t installed anything new. Everything was working fine yesterday.

  3. Wow that’s brilliant…instructions for how to restore Kodi when it’s booted up – how about when KODI FREEZES ON STARTUP AND YOU CAN’T DO ANYTHING? herp a derp…

  4. My KODI won´t recognize subtitles provider and takes longer to start .
    Is it possible to reinstall without loosing my addons, it came with tv box and I don´t know how to install them after

  5. Kodi auto updated to version 17.5 on my android box and would never start. I uninstalled and reinstalled several times still no luck. Tried version 18.0 but it was not compatible with Kodi No Limits. Went back to version 17.4 turned off auto update.

  6. So my box failed after an auto update to 17.5. I uninstalled my build, uninstalled Kodi again. 4 times, same result, it wouldn’t start. So it wasn’t a build fault. I downloaded Kodi 18, and then had to load a different build, as the one I used to use won’t work on 18. So now I have to learn a new build again. Too bad these boxes won’t just work without all this mucking around.

  7. After my android updated from 17.4 to 17.5 stopped working done 5 fresh downloads with different addons stills same problem.now going back to 17.3 or 17.4,and will stop auto update

Leave a Comment

CRAZY Kodi VPN OfferClick Here