Differences

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

--- troubleshooting [2023/10/29 05:25] – [x86/x86_64] Add backlink to TPM configuration maximumentropy
+++ troubleshooting [2026/03/28 18:41] (current) – ↷ Links adapted because of a move operation 92.184.108.195
@@ Line 1: / Line 1: @@
 ====== System Troubleshooting ======
+If going to our [[https://discord.gg/ndyUKA5|Discord]] for help, gather the relevant logs (as described below) and upload them along with your message. This will help us help you better.
 ===== Emulators not launching/EmulationStation logs =====
@@ Line 49: / Line 51: @@
   * [[systems:fpinball|Future Pinball]]
   * [[systems:jaguar|Jaguar]] (BigPEmu)
-  * [[systems:xash3d_fwgs|xash3d_fwgs]]
+  * [[systems:halflife|xash3d_fwgs]]
-If you want to continue using your NAS for the majority of your games, but to use your internal storage for these affected systems so they can continue to work (not being on your NAS, obviously), save the following script as ''/userdata/system/custom.sh'':
-<file bash custom.sh>
+If you want to continue using your NAS for the majority of your games, but to use your internal storage for these affected systems so they can continue to work (not being on your NAS, obviously), save the following file as a [[scripting_services_rules_examples#batocera_services|service]] in ''/userdata/system/services/nas_workaround'' (no extension):
+<file bash nas_workaround>
 #!/bin/bash
 # This allows you to still use Windows/Flatpaks even while using a NAS.
@@ Line 71: / Line 74: @@
 </file>
+After uploading or creating the file, run ''batocera-services enable nas_workaround'' to activate the service at boot. Rebooting or running ''batocera-services start nas_workaround'' should create all the nescessary mountpoints in /media/.
 <WRAP center round info>
@@ Line 176: / Line 181: @@
   * If the system has a UEFI BIOS, and Secure Boot can't be disabled, and legacy boot is not available, see the [[secureboot|Secure Boot]] page for setup instructions.
   * If the system has a Trusted Platform Module (TPM) that is enabled, Batocera **v39** and higher will display ''Boot Option Restoration'' and reboot after five seconds, repeating until the required  [[secureboot#TPM|TPM Configuration]] is performed.
+  * If using Grub bootloader on UEFI to chainload the Batocera bootloader, ensure that the correct path is being chainloaded:
+    * For Batocera **v39** and higher: ''/EFI/batocera/bootx86.efi''
+    * For Batocera **v38** and lower: ''/EFI/BOOT/bootx86.efi''
   * If also using Windows on the same machine, ensure that Windows isn't hibernating or otherwise holding the system access hostage by some means (fast boot, quick start, etc.)
     * Windows 8 and above have renamed the "Hibernate" function to "Shut down" (technical term is "fast startup (hybrid shutdown)"). To properly shutdown, [[https://www.top-password.com/blog/fully-shutdown-windows-10-instead-of-hibernating-it/|hold down the SHIFT key while selecting "Shut down" from the Start menu]]. [[#batocera_can_t_read_my_hard-drive_using_its_file_manager_i_know_it_s_fine_because_i_boot_windows_off_of_it|You can also permanently turn this "feature" off.]]
@@ Line 185: / Line 193: @@
   * Try disabling/enabling the IOMMU setting in your BIOS.
   * Try switching AHCI/SATA/NVMe settings in your BIOS for the drives in question (some BIOS only have this as a global setting).
-  * Ensure that ''nvidia-driver'' and ''nvidia-prime'' are set to ''false'' in ''batocera-boot.conf''. [[:edit_boot_partition|How to edit the boot partition.]]
+  * If your motherboard's EFI shell is unable to load or select Batocera's EFI partition (common on Mac hardware), consider replacing it with the more universal [[https://www.rodsbooks.com/refind/|rEFInd Boot Manager]]. It's recommended to read through the entire page and understand it first before going through with the process.
-  * If your motherboard's EFI shell is unable to load or select Batocera's EFI partition (common on Mac hardware), consider replacing it with the more universal [[https://www.rodsbooks.com/refind/|rEFI Boot Manager]]. It's recommended to read through the entire page and understand it first before going through with the process.
 === Verbose boot ===
@@ Line 217: / Line 224: @@
 <--
+=== Legacy boot ===
+On x86_64 legacy boot systems, if the file ''/boot/boot/syslinux/ldlinux.sys'' is modified in **any** way, a situation may be created where future modifications of any kind to the ''BATOCERA'' /boot partition (including Batocera version upgrades/downgrades) may trigger a black screen at boot with the message "Boot error".
+To recover from this:
+  - Boot from a Linux distribution on another drive (procedure was tested with the live installer''ubuntu-23.10.1-desktop-amd64.iso'')
+  - Get to a root shell ("Try Ubuntu", start a terminal, ''sudo -i'')
+  - Attach the Batocera drive, if not already attached
+  - Ensure that the Batocera boot partition is **not** mounted: ''umount $(blkid -L BATOCERA)''
+  - Ensure that the "syslinux" package is installed.  For a Debian or Ubuntu system: ''apt install syslinux''
+  - Reinstall the bootloader (Note: It's OK if this produces warnings like "Hidden (2048) does not match sectors (63)"): ''syslinux -i $(blkid -L BATOCERA) -d /boot/syslinux''
 ==== Single board computer (RPi, Odroid, etc.) ====
@@ Line 344: / Line 364: @@
 ==== I can see the drive but still can't access it! ====
-Maybe you have Bitlocker drive encryption enabled? This is a feature of Windows that allows you to encrypt your drive's data such that only Windows can see it. It is not enabled by default, but it could have been unintentionally activated.
+Maybe you have Bitlocker drive encryption enabled? This is a feature of Windows that allows you to encrypt your drive's data such that only Windows can see it. It is enabled by default since around 2024.
 First, type "bitlocker drive encryption" into the Start menu and select the identically named option. Make sure your hard-drive says "Off" in its Bitlocker encryption status.
@@ Line 364: / Line 384: @@
 ===== Create a Batocera support file =====
-In case you want to share a snapshot of your system log files to [[:report_issue|help developers diagnose your machine]] you can use the menu **SYSTEM SETTINGS** -> **FRONTEND DEVELOPER OPTIONS** -> **CREATE A SUPPORT FILE**. It will generate a tarball in ''/userdata/saves/'' named ''batocera-support-YYYYMMDDHHMMSS.tar.gz'' (with year/date/time of creation in the filename). You could also create this by running ''batocera-support'' from [[:access_the_batocera_via_ssh|SSH]]. This tarball might contain sensitive data such as your Wi-Fi/RetroAchievements password in plain-text, so be careful of where you share it to. Your:
+In case you want to share a snapshot of your system log files to [[:report_issue|help developers diagnose your machine]] you can use the menu **SYSTEM SETTINGS** -> **FRONTEND DEVELOPER OPTIONS** -> **CREATE A SUPPORT FILE**. It will generate a tarball in ''/userdata/saves/'' named ''batocera-support-YYYYMMDDHHMMSS.tar.gz'' (with year/date/time of creation in the filename). You could also create this by running ''batocera-support'' from [[:access_the_batocera_via_ssh|SSH]].
+<WRAP center round important>
+This tarball might contain sensitive data such as your Wi-Fi/RetroAchievements password in plain-text, so be careful of where you share it to. Your:
   * Wi-Fi SSID and password is in ''system/batocera.conf'' and ''system/batocera-boot.conf''
   * RetroAcheivements username and password are in ''system/batocera.conf''
@@ Line 371: / Line 393: @@
 You could also just use a freshly installed Batocera that contains no such information instead to create the support file.
+In Batocera **39** or later, most sensitive data will be scrubbed from the support file automatically.  Please file a Github issue report if any sensitive data is found in support files from recent versions.
+</WRAP>
 ===== Factory reset =====