This is an old revision of the document!




Installing LibreELEC on your RaspberryPi is very easy. Follow the instructions below.

Mandatory things

There is a little list of things you will need:

  • a PC which is used to write the image to a SD-card (can be Linux, Windows or MacOS based)
  • a Raspberry Pi
  • a proper power supply (5V/1A for the RPi1; 5V/2A for the RPi2/3)
  • a SD-card with at least >=2GB (4-16GB is recommended)
  • a Micro-USB cable
  • an internet connection
  • a HDMI cable
  • a keyboard/mouse

Optional things

This is a list of optional things you might need:

  • an ethernet cable
  • a WiFi dongle
  • a remote
  • a case for the RPi
  • MPEG2 and VC-1 licenses (this will be explained at Raspberry Pi Config.txt)

USB-SD Creator tool

LibreELEC USB-SD Creator While you can still use the instructions on this page, LibreELEC now has a tool for Windows, Mac OS X, and Linux that will do all the work for you to create a Raspberry Pi LibreELEC installation on an SD card. See the Installation of LibreELEC page for details.

Let's begin

First you need to download a matching image from here:

red||**Note:** Be sure you took the correct image as the wrong one won't work. The image for the RPi1 will work for the RPi1 and the RPi Zero. The image for the RPi2 will work for the RPi2 and RPi3.

The process for writing the image to your SD-card is the same as for writing it to a USB stick. For writing the image please follow these instructions: Writing the image

After you have written the image to the SD-card, safely remove it from your PC, plug it into your RPi, connect the RPi to your TV and power it on. If all went well you will end up directly at Kodi

Have fun with it ;)


If you are using a Raspberry Pi 1, just update it using the RPi2/3 *.tar file. After the system is updated it will reboot itself and you will end up in a rainbow boot screen. That's quite normal as the RPi1 can't handle the build for RPi2. Plug out the power, transfer your SD-card to your RaspberryPi 2 and power it on. It will boot normally.

The same can be done if you want to update your RPi2 SD-card to be used in the RPi1. Update the RPi2 but use the RPi1 *.tar file. As above, the system will reboot itself to a rainbow boot screen. Power it off, transfer the card to the RPi1 and boot that, which will boot fine then.

red||**Note:** LibreELEC 8.0 builds (alpha onwards) automatically check update files for compatibility by comparing PROJECT name in the update file against PROJECT name of the current installation. Incompatible updates; e.g. a Raspberry Pi Zero (which runs the RPi image) attempting update to the RPi2 image will fail the check and the update is blocked. To reuse an RPi1 SD card with an RPi2/3 device create /storage/.update/.nocompat first to override the compatibility check.

See also