Batocera allows powerful advanced options through the file:
/boot/batocera-boot.conf
This guide shows you step-by-step how to edit it via SSH, even if you’re completely new.
1️⃣ Enable SSH in Batocera
- Boot Batocera
- Main Menu → System Settings
- Developer → Enable SSH
- Set to ON
- Restart Batocera
2️⃣ Find Your Batocera IP Address
- Press Start
- Go to Network Settings
- Note the IP Address (example: 192.168.1.45)
3️⃣ Connect to Batocera via SSH
Below are instructions for your operating system.
🟦 Windows
Option A — PowerShell / Windows Terminal (recommended)
ssh root@BATOCERA-IP
Example:
ssh root@192.168.1.45
Password:
linux
Option B — PuTTY
🟩 macOS
Open Terminal and type:
ssh root@BATOCERA-IP
Password:
linux
🟧 Linux
In your terminal:
ssh root@BATOCERA-IP
Password:
linux
4️⃣ Edit batocera-boot.conf
First, make the boot partition writable:
mount -o remount,rw /boot
Open the configuration file with nano:
nano /boot/batocera-boot.conf
You will see entries like:
#global.videooutput=auto
#global.videomode=1920x1080
#nvidia-driver=true
#splashscreen=off
Remove the # to activate a setting:
Example:
global.videomode=1920x1080
💾 Save your changes (nano)
- CTRL + O → Save
- Press ENTER
- CTRL + X → Exit
5️⃣ Reboot Batocera
In SSH:
reboot
Your new settings are active after restart.
✔ Optional: Verify Your Changes
nano /boot/batocera-boot.conf
or check system logs:
dmesg | less
🎉 Finished!
You have successfully edited batocera-boot.conf using SSH.
This unlocks advanced boot and video configuration options for Batocera.
