Differences

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

--- install_batocera [2023/10/25 09:53] – remove unneccesary step 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.
@@ 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 =====