Updating OpenELEC

From OpenELEC
Jump to: navigation, search
Home icon grey.png   ▶ installation ▶ Updating OpenELEC

Updating OpenELEC isn't like updating any other operating system you'll have used before. There's no package manager, and no terminal usage.

Update Methods

In the OpenELEC settings you have the option to enable automatic or manual updates.

Automatically Updating OpenELEC

If Automatic updates option is enabled, OpenELEC will check online for an update. If it finds one the update will be downloaded and prepared. You will then be notified that a reboot is required to apply the update.


Manually Updating OpenELEC

If Manual update option is selected then you will need to download the update to OpenELEC. This is ideal if the OpenELEC machine is not internet connected as you can download the new software package on another machine and provide the file to your OpenELEC.

First of all, head over to the downloads page and download the latest release of OpenELEC. You will need to download the standard software package, not the disk image version.

Now, from your PC, open an Explorer window and browse to the IP address of the OpenELEC machine (if you don't know what the IP address of your OpenELEC box is, go to the menu of the OpenELEC machine, and browse to the main item "System" and then look at the subitem "System Info". This will open a page that shows the IP address amongst other information.

So type this into the address bar of the explorer window. For example, if your OE machine's IP address is, browse to:


Once the window appears, open the "Update" folder share. There shouldn't be anything inside this share, unless you have another update pending. Copy the downloaded OpenELEC software (for example: OpenELEC-Generic.x86_64-5.0.0.tar) to the folder.

Once the file has been copied, reboot the OpenELEC machine. OpenELEC will recognize the new software package in the update folder and update automatically. A second reboot will follow automatically to activate the new system files.

Using SCP or SSH

This is for more advanced users. If you did what is described above, you don't need to worry about this. If you are not using the method described above, it's good to know that the folder where you need to place the software package is /storage/.update.

Then you can use SCP to copy the file or run wget on the OpenELEC box itself.

Updating OpenELEC 4.x to 5.0

The automatic update function will not make a major update from 4.0/4.2 software towards 5.0. Major updates are not done because major steps in versions can lead to unstable setups as too many settings have changed between the versions. You can update manually though.

If you do want to go ahead with the upgrade, doing a -full- backup of your OpenELEC setup first is recommended at all times. Use the Backup/Restore tool in the OpenELEC Setting add-on, and place the backup file in a secure location. That means NOT on the same OpenELEC htpc you are making the backup of.


If for whatever reason the new build is not working properly on your OpenELEC machine, you can also downgrade to a lower version in the same way as you do an upgrade. All provided that the Samba server is still working properly.

You can downgrade from a major version to another major version, but it is not advised. Various settings and add-ons are not backwards compatible. Should you want to do a major downgrade, a fresh installation of OpenELEC is highly recommended. Minor downgrades, for example from 4.2.1 to 4.0.4 are fine though.