Approvals: 0/1
This is an old revision of the document!
Manual upgrades/downgrades
This is for if you:
- can't upgrade/downgrade from stable to beta or vice versa using MAIN MENU > UPDATES & DOWNLOADS > UPDATE TYPE > “Stable” or “Beta” and updating,
- want to downgrade to an older revision,
- want to install a custom version of Batocera,
To upgrade/downgrade manually:
- 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/). - 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 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.
Alternatively (from Batocera 5.23 onwards) you can do this from SSH. Get the URL to the right architecture's last
folder and run: batocera-upgrade [URL]
. For example, if you were on the x86_64 platform: batocera-upgrade https://batocera.org/upgrades/x86_64/stable/last
. You should then see output similar to this:
Starting the upgrade... url: https://updates.batocera.org/x86_64/stable/last/boot.tar.xz need to download 1876mb m/upgrade/boot.tar.xz 0%[ ] 9.55M 1.82MB/s eta 19m 42s
For Batocera 5.7 to 5.22, the command 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 download the compressed upgrade (or potentially downgrade) file and expands it to overwrite the Batocera system. Upgrading or downgrading like this doesn't remove any of your user data (ROMs, saves, 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 while attempting to upgrade, there might be several reasons:
- Your drive is less than 8GB total. Batocera can run on these drives but you will be missing out on using the built-in updater.
- The splash video file(s) (which are copied to the
/boot
partition) are/is taking up too much space. Remove them/it, reboot and try to upgrade again. - Your first installation was an older version of Batocera, where the
/boot
partition was initially assigned less space (compared to installations of newer Batocera versions).
To work around this, you can any one of the following:
- Insert your drive into another computer, back up the contents of the FAT32 boot partition of the drive (Windows should only be able to see this partition and nothing else by default), delete the
/boot/batocera
file (it is just calledbatocera
without a file-extension and is about 2 GB large (smaller in older versions)) and extract theboot.tar.xz
file to the root of that partition. Rename the freshly extracted/boot/batocera
file tobatocera-update
, then boot Batocera. Be aware that by doing this you would have to do this manual workaround every time. - Boot into Batocera, SSH in or use the file manager's xterm and run
mount -o remount,rw /boot
. Backup your/boot/boot/batocera
file to another device (cp /boot/boot/batocera /userdata/system/batocera-backup
, or you can exit the xterm with Alt+F4 and then use the file manager to copy the file to your/userdata/system
folder). Then run the following command to delete thebatocera
file and immediately upgrade:rm /boot/boot/batocera && batocera-upgrade
You should get an output that looks like this:
Starting the upgrade... url: https://updates.batocera.org/x86_64/beta/last/boot.tar.xz need to download 1876mb m/upgrade/boot.tar.xz 0%[ ] 9.55M 1.82MB/s eta 19m 42s
Be aware that by doing this you would have to do this manual workaround every time.
- Flash a spare USB/portable hard-drive with a new copy of Batocera and boot into that, copy all your
/userdata
(everything in Share) from your old Batocera drive to your spare USB/portable hard-drive and then reflash the old Batocera drive with a new version of Batocera (or just continue to use your spare USB/portable hard-drive). - Backup your
/userdata
to another device (you may lose file attributes by doing this, causing problems with WINE/Cemu) and reflash Batocera.
The Batocera USB key
- upgrade_manually.1631252141.txt.gz
- Last modified: 3 years ago
- by atari