This is an old revision of the document!

Installation of LibreELEC

The official “LibreELEC USB-SD Creator” tool helps you choose and download the latest builds and for your hardware and create bootable USB and SD Card media.


The LibreELEC USB-SD Creator tool is available for Ubuntu Linux 14.04 32/64 bit and newer (and should also work on other Debian derivatives), macOS 10.9 and newer, and Windows XP and newer.





Launching the App


Download the LibreELEC USB-SD Creator and double click on the .exe file you will have in your “Download” folder.


Download the LibreELEC USB-SD Creator and double click on the .dmg file you will have in your “Download” folder. This will mount the disk image on your desktop. You can run the application directly from the disk image or copy it to your /Applications folder.

If the application displays a warning about not being from a known developer when first run, you will need to go to “System Preferences” then “Security and Privacy” and either click “Open Anyway” or allow “Apps downloaded from anywhere”. If the change concerns you, permissions can be changed back after you use the app.

Once the app launches it will ask for your username and password. This is because the macOS requires superuser (sudo/root) permissions to write directly to the USB or SD card.


Download the LibreELEC USB-SD Creator. After the download has finished, open a terminal and enter the following commands (assuming “Downloads” is your default download folder and the filename is matching):

cd ~/Downloads
chmod +x LibreELEC.USB-SD.Creator.Linux-32bit.bin
or for 64bit
chmod +x LibreELEC.USB-SD.Creator.Linux-64bit.bin 

Now you are able to start the tool from the command line by entering:

sudo ./LibreELEC.USB-SD.Creator.Linux-32bit.bin
or for 64bit
sudo ./LibreELEC.USB-SD.Creator.Linux-64bit.bin


Select Version

Choose the project and the LibreELEC version you need. Available options are downloaded live from our servers, e.g.

  • Cubox-i2/i4 and Hummingboard (imx6)
  • Generic x86_64
  • RaspberryPi 2 and 3
  • RaspberryPi zero and 1
  • Wetek Core
  • Wetek Play
  • Wetek Hub

The available LibreELEC versions depend on the hardware/project you select and the files available on our server for that project:

Download image file

After you selected the hardware/project and version hit the Download button. This will download the selected image to your specified 'Download' folder. You can also select a previously downloaded image file on your machine for installation. Hit the Select file button and browse your computer for the .img.gz file.

Select USB stick or SD card

Select the USB stick or SD card that you want to write the image to. Click on the refresh button if the removable device is not listed.

Write image

After you select the hardware/project, version, and target devices the Write button is available. Click it to write the image.

Writing done

Once the image finishes writing to the USB stick or SD card hit the Close button to exit the LibreELEC USB-SD Creator. If you see an immediate “Write error” please check the write-protect tab on the SD card. This puts the card into read-only mode and writing will fail.

Support and Assistance

If you need further help and support with creating installation media please post in the LibreELEC USB-SD Creator support forum.