Differences

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

Link to this comparison view

Next revision
Previous revision
Next revisionBoth sides next revision
modify_the_system_while_it_s_running [2020/01/28 20:48] – created genetik57modify_the_system_while_it_s_running [2021/04/09 14:29] – [Other system files] edited the location of the exemple, as python3.9 is used nowadays. fishou
Line 1: Line 1:
-~~NOTOC~~ +====== Modify the system while it's running ====== 
-===== Modify the system while it's running ===== +By default, batocera.linux is like a firmware. It's a file called ''/boot/batocera''
-By default, batocera.linux is like a firmware. It's a file called /boot/batocera. +You cannot modify it directly, and for most use cases, you shouldn't need to modify itAll the user data is stored in ''/userdata/'', which is writable. 
-You cannot modify it directly. However, in case of need, there are tips to do it.+ 
 +That said, in case you need to modify the system, there are tips to do it. 
 + 
 +===== /boot/ directory ===== 
 +For any modification in ''/boot'':
  
-  # for /boot 
   mount -o remount,rw /boot   mount -o remount,rw /boot
      
-  # for other modifications + 
-  # do any modification +===== Other system files ===== 
-  # if you reboot, the modifications are lost, +For any other modifications, you can directly edit the files in their directory (for example if you want to play with the configgen scripts in ''/usr/lib/python3.9/site-packages/configgen/generators/''). Once the modifications are done, you can save them with the command: 
-  # except if you saved them via+
   batocera-save-overlay   batocera-save-overlay
      
-This script creates a file at ''/boot/boot/overlay'' file that stores all the modifications you made. **WARNING**: this overlay file is automatically removed at the next upgrade.+This script creates a file at ''/boot/boot/overlay'' file that stores all the modifications you made. 
 + 
 +<WRAP center round important 50%>**WARNING**: This overlay file is automatically removed at the next upgrade.</WRAP> 
 + 
 +If you don't use the ''batocera-save-overlay'' script, you can still edit the files in ''/usr/'' but any modification will be lost on reboot. 
 + 
 +If you want to remove all your customizations, just remove this ''/boot/boot/overlay'' file.
  
-If you want to remove all your customizationsjust remove this ''overlay'' file.+By default, Batocera overlay files are limited to 50MB. If your modifications are over 50MB, you can specify the size of the overlay with the command. Keep always a bit of margin, the overlay will embed a few more files than those you were expecting (some system files created on-the-fly at boot time). For example, if you need to save 120MB of data on the systemyou can type ''batocera-save-overlay 120''.
  
-Note : it cannot be done for the current Odroid xu4 version.+**Note** : it cannot be done for the current Odroid xu4 version.
  
-=== Cases when you don't need to modify the system === +===== Cases when you don't need to modify the system ===== 
-  * you generally don't need to edit ''/etc/fstab'', use [[store_games_on_a_nas]] instead. +Some best practices here: 
-  * you should not modify ''/usr/share/emulationstation/es_systems.cfg'', instead, copy this file to ''/userdata/system/configs/emulationstation/es_systems.cfg'' and customize it from thereAt startupEmulationStation prefer the latter file if it exists.+  * You generally don't need to edit ''/etc/fstab'', use [[store_games_on_a_nas]] instead. 
 +  * You should not modify ''/usr/share/emulationstation/es_systems.cfg''Insteadfollow the instructions in [[emulationstation:customize_systems|the Customize sytems page]].
  • modify_the_system_while_it_s_running.txt
  • Last modified: 12 months ago
  • by maximumentropy