Differences

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

--- install_batocera [2023/06/24 05:10] – simplify warning on write step and format question, embolden atari
+++ install_batocera [2026/03/30 13:53] (current) – Fixed file name pattern lbrpdx
@@ Line 12: / Line 12: @@
 Generic instructions for most platforms are as follows:
-  - Download [[https://www.raspberrypi.com/software/|Raspberry Pi Imager]] for your operating system. {{ :install_rpi_imager_01.png?direct&640 |}}
+  - Download an image flashing tool for your operating system such as [[https://www.raspberrypi.com/software/|Raspberry Pi Imager]] or [[https://gitlab.com/bztsrc/usbimager|USBImager]]. We will be using Raspberry Pi Imager in these instructions. {{ :install_rpi_imager_01.png?direct&640 |}}
   - Download an image file from the [[https://batocera.org/#download|download section on the Batocera website]] that matches the architecture you want to use for Batocera (x86_64 for most PCs, other devices usually have their own specific image). <WRAP center round important>
 Some browsers like Chrome/Opera/Safari may take the liberty to unzip the file by themselves and poorly rename them. If the file is more than 4 GB, it is already unzipped. If your download fails, use another browser. Yes, Chrome sucks, that's a fact, use another browser.
 </WRAP>
-  - Insert the intended USB drive, SD card or hard-drive into your computer. 8 GB is the minimum for **v30** and up, 16 GB and above is recommended for full functionality (you cannot automatically download updates with only 8 GB).
+  - Insert the intended USB drive, SD card, hard-drive or SSD (you can attach one via a SATA/M.2 to USB cable) into your computer. 16 GB storage space is the minimum, 32 GB is recommended for full functionality (you cannot automatically download updates with only 16 GB).
   - Install and run Raspberry Pi Imager.
   - Click **CHOOSE OS**. {{ :install_rpi_imager_02.png?direct&540 |}}
   - Scroll down and select **Use custom**. {{ :install_rpi_imager_03.png?direct&540 |}}
-  - Select the image ''batocera-(version)-(arch)-(date).img.gz'' that you just downloaded. {{ :install_rpi_imager_04.png?direct&540 |}}
+  - Select the image ''batocera-(arch)-(version)-(date).img.gz'' that you just downloaded. {{ :install_rpi_imager_04.png?direct&540 |}}
   - Click **CHOOSE STORAGE** and select the USB drive, SD card or hard-drive. {{ :install_rpi_imager_05.png?direct&540 |}} {{ :install_rpi_imager_06.png?direct&540 |}}
-  - Click **WRITE** and confirm that it is the correct destination (triple-check it's the correct drive before proceeding, as <wrap em>all existing data on the drive will be destroyed!</wrap>) {{ :install_rpi_imager_07.png?direct&540 |}}
+  - Click **NEXT**. {{ :install_rpi_imager_07.png?direct&540 |}}
+  - Click **NO**. {{ :install_rpi_imager_07b.png?direct&540 |}}
+  - <wrap em>Confirm</wrap> that it is the correct destination (triple-check it's the correct drive before proceeding, as <wrap em>all existing data on the drive will be destroyed!</wrap>), then click **YES**. {{ :install_rpi_imager_07c.png?direct&540 |}}
   - Wait patiently for the writing to finish, this may take a while depending on the speed of the card/drive. <WRAP center round important>
 Windows may offer to format the drive thinking it is a new device, cancel this request otherwise Batocera will be wiped out.
-</WRAP>
+</WRAP> {{ :install_rpi_imager_08.png?direct&540 |}}
- {{ :install_rpi_imager_08.png?direct&540 |}}
     * In case the flash fails outright, try closing down any unnecessary software such as anti-virus programs or virtual machines and try again.
-  - Upon finishing, check that the image has been written successfully. {{ :install_rpi_imager_09.png?direct&540 |}}
+  - Upon finishing, check that the image has been written successfully. {{ :install_rpi_imager_09.png?direct&540 |}}\\ <WRAP center round tip>
-  - Reinsert your USB drive, SD card or hard-drive and check that it contains a boot folder (files differ depending on architectures). This partition will be smaller than the total size of the drive, don't worry as this is just Batocera's boot partition! {{ :boot-partition1.png?nolink&600 |The boot partition.}}
+At this point, the drive contains a ''BATOCERA'' boot partition (files differ depending on architectures). This partition will be smaller than the total size of the drive, don't worry as this is just Batocera's boot partition! {{ :boot-partition1.png?nolink&600 |The boot partition.}} The drive also contains a ''SHARE'' partition which will be expanded the first time the drive is booted, to consume any unallocated space, and which is not normally visible to Windows.
+</WRAP>
   - Shut down your computer and insert your USB drive, SD card or hard-drive into the machine you want to boot with Batocera and turn it on.
   - Ensure your device will boot into the USB drive, SD card or hard-drive:
@@ Line 35: / Line 37: @@
     - If on a recent PC using an x86/x86_64 build, you may need to [[#bios_settings_(if_batocera_fails_to_boot)|disable Secure Boot in your BIOS settings]].
     - If on a PC, you may need to enter the boot selection menu with ''[F10]'', ''[F11]'' or ''[F12]'' and select the Batocera drive. UEFI is preferred if available, but not necessary. {{ typical-boot-menu.jpg?nolink&323 |Here my Batocera USB stick simply appears as "Generic STORAGE DEVICE"}}
-  - Boot the Batocera drive and let it automatically expand the userdata partition (could take a few seconds or a few minutes, depending on your drive size/speed), it will reboot again once done. Don't turn off the device during this step or you might risk data corruption! {{ :batocera_resize_partition.jpg?540 |}}
+  - Boot the Batocera drive and let it automatically expand the userdata partition (could take a few seconds or a few minutes, depending on your drive size/speed), it will reboot again once done. Don't turn off the device during this step or you might risk data corruption! {{ :batocera_resize_partition.jpg?540 |}} <WRAP center round info>
+If instead another blue screen appears saying verification failed this means you are in secure boot mode and have not enrolled Batocera's keys yet. Press ''Enter'' and follow the on-screen prompts to do so, for further info refer to the [[:secureboot|the secure boot page]]. {{secure_boot_x64_-_2_-_error_verification_failed_0x1a_security_violation_-_screenshot_2023-10-20_121355.png?w=540}} {{tpm_1_boot_option_restoration.jpg?w=600}}
+</WRAP>
   - Enjoy! =) {{ https://batocera.org/images/blog/Pictures/Version_29/output001.png?nolink&540 |Of course, your installation is probably in English.}}
@@ Line 85: / Line 89: @@
 ===== Mac boot order selection =====
-To access the boot selection screen on Mac, hold the ''[Option]'' (''[Alt]'' on ASCII keyboards) key while booting. On newer UEFI Macs, you may first need to turn Secure Boot to "No Security" and enable "Allow booting from external media" from the recovery mode (accessed by pressing and holding ''[CMD]'' (''[Win]'' on ASCII keyboards)+''[R]'' immediately after you see the Apple logo while booting).
+=== Before booting: Disable Secure Boot and enable booting from external media (On Newer UEFI Macs) ===
+  * Reboot your MAC, at Apple logo press and hold ''[CMD]'' (''[Win]'' on ASCII keyboards)+''[R]''
+  * Mac will starts the macOS recovery mode, select and login with your admin account.
+  * At top menu bar, select ''Utilities'' >> ''Startup Security Utility'', and enter you admin account password again.
+  * Changes Secure Boot to ''No Security'' and Allowed Boot Media to ''Allow booting from external or removable mode''.
+  * Close it and Restart your Mac.
+  * Follow instructions on next section...
+==== Startup Batocera ====
+To access the boot selection screen on Mac, hold the ''[Option]'' (''[Alt]'' on ASCII keyboards) key while booting.
 <WRAP center round tip>
@@ Line 99: / Line 114: @@
 This indicates that your machine will default to booting from this device. Hold ''[Ctrl]''+''[Return]'' (''[Enter]'' on ASCII keyboards) to confirm.
+<WRAP center round important>
+On Macbooks especially, some hardware such as the touchpad or keyboard may not be supported under Linux. Fortunately, Batocera is functional with a controller alone.
+</WRAP>
 ===== Install Batocera from Batocera =====