Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revisionBoth sides next revision
upgrade_manually [2020/02/07 17:37] lbrpdxupgrade_manually [2021/08/27 13:27] – general cleanup atari
Line 1: Line 1:
-~~NOTOC~~ +====== Manual upgrades/downgrades ====== 
-===== Manual upgrades ===== +In the case that you can't upgrade/downgrade from stable to beta using the **Main Menu** > **Updates & Downloads** > **Update Type** > STABLE/BETA and updating, or you want to downgrade to an older revision, or you want to install a custom version of Batocera, you can upgrade/downgrade manually.
-Upgrades can be done manually : +
-  * in case you want to reinstall a previous version +
-  * in case the upgrades are broken +
-  in case you want to upgrade to a custom version+
  
-To upgrade manually : +To upgrade/downgrade manually: 
-  - download the file boot.tar.xz of the version you want. The official ones are available here : http://batocera.org/upgrades +  - Download the ''boot.tar.xz'' file of the version you want. The official ones are available at http://batocera.org/upgrades (for older versions use https://mirrors.o2switch.fr/batocera/, navigate to your architecture and go to /stable/last/archives/). 
-  - ''.tar.xz'' file is an archive format, like a ''.zip''. Just unzip this file onto your SD card/USB key to replace existing files.+  - Unzip the ''.tar.xz'' file (it's just like a ''.zip'', you can use 7-zip on Windows) onto your SD card/USB key's [[edit_boot_partition|boot partition]] (This partition is readable on Windows regardless of the filesystem you have chosen for the SHARE. You may have to assign a drive letter under Windows Disk Management to see it in the file explorer) to replace existing files.
  
-Or, starting with batocera.linux 5.23: +Alternatively (from Batocera 5.23 onwards) you can do this from the command line by
-  - [[access_the_batocera_via_ssh|from SSH]], adapt the url to the right architecture and run : ''batocera-upgrade https://batocera.org/upgrades/x86_64/stable/last'' (this example is for PC x86_64, please adapt the URL to the right architecture) +  - [[access_the_batocera_via_ssh|from SSH]], adapt the url to the right architecture and run: ''%%batocera-upgrade https://batocera.org/upgrades/x86_64/stable/last%%'' (this example is for PC x86_64, please adapt the URL to the right architecture)
- +
-For batocera.linux 5.7 to 5.22: +
-  - [[access_the_batocera_via_ssh|from SSH]], the command line would be: ''/recalbox/scripts/recalbox-upgrade.sh https://batocera.org/upgrades/x86_64/stable/last'' (for PC x86_64, please adapt to the right architecture)+
  
 +For Batocera 5.7 to 5.22:
 +  - [[access_the_batocera_via_ssh|from SSH]], the command line would be: ''%%/recalbox/scripts/recalbox-upgrade.sh https://batocera.org/upgrades/x86_64/stable/last%%'' (for PC x86_64, please adapt to the right architecture)
  
 These commands upgrade -- or potentially downgrade -- the Batocera system. Upgrading or downgrading //doesn't remove// any of your user data (ROMs, metadata...). Like never, ever. These commands upgrade -- or potentially downgrade -- the Batocera system. Upgrading or downgrading //doesn't remove// any of your user data (ROMs, metadata...). Like never, ever.
  
 +===== Error messages when upgrading =====
 +
 +If you get an error message telling you that you don't have enough space on your Batocera system partition when you upgrade, there might be several explanations. 
 +
 +One of them is that you have [[splash_boot|stored several splash boot video files]] on the ''/boot'' partition. Remove them, and try to upgrade again. 
 +
 +The other explanation: Your first installation was an older version, where the boot-partition was smaller (in newer versions of batocera the space had to be rised because of more features).
 +In this case, you could either delete the "batocera"-file (it is just called batocera, without a file-extension, is about 1gb big and is located in the boot folder of the first/boot partition).
 +After that, extract the boot.tar.xz file onto that drive and if successfull, rename the file "batocera-update" located in the boot folder to just "batocera").
 +But be aware, that you would have to do this manual workaround (update-procedure) every time, you want to update to a new version.
 +
 +So it may be better, to backup all the files from your share-partition (roms, saves, bios, etc.) and start a fresh new install, by flashing the .img.gz file with for example balenaEtcher onto the drive, where you want to have batocera installed, then boot from it and copy back all roms, saves etc. to the share-partition of this new installation of batocera.
 +
 +===== The Batocera USB key =====
  
-==== The batocera.linux usb key ==== +{{system:usbkey.png?700|An illustration showing how the batocera system is laid out on a USB stick: the BATOCERA partition first, containing all the programs, and then the SHARE, containing all the userdata}}
-{{system:usbkey.png?700|}}+
  • upgrade_manually.txt
  • Last modified: 4 months ago
  • by maximumentropy