EmuELEC has established itself as the gold standard for turning low-cost Amlogic-based Android TV boxes (like the X96, HK1, and Vontar) into dedicated retro gaming consoles. Built on the backbone of CoreELEC and LibreELEC, EmuELEC transforms your hardware into a streamlined Linux distribution running EmulationStation as its frontend and RetroArch as its backbone.
But what happens when your wireless gamepad stops syncing? Or when you need to scrape thousands of ROMs without bogging down the system’s GUI? Or when your device gets stuck in a boot loop?
You need SSH (Secure Shell).
This article is your exhaustive manual on using SSH with EmuELEC. We will explore why you need it, how to set it up, what commands to run, and how to fix it when it breaks.
Version Applicability: EmuELEC 3.x / 4.x (Amlogic, Rockchip, and Generic builds) Target Audience: System Administrators, Advanced Users, Developers emuelec ssh
Now for the fun part. You are logged in. What do you type? Here is your cheat sheet for managing your retro gaming system via SSH.
# Connect
ssh root@emuelec.local
Part 5: Essential Commands for EmuELEC Power Users
You are now root, with no guardrails. Use these commands wisely.
1. Restarting the EmulationStation Frontend
If the GUI freezes but SSH works:
systemctl stop emustation
systemctl start emustation
Or, using the EmuELEC script:
/usr/bin/emustation.sh restart
2. Changing the Resolution Remotely
If you plugged your box into a 4K TV but it is glitching:
ee-settings set resolution "1080p"
reboot
3. Checking Storage Space
Low space causes save state failures.
df -h
Look for /storage usage. If it hits 95%, delete old ROMs or logs.
4. Fixing Corrupted Game Database
If games aren't showing up, rebuild the gamelist: Mastering EmuELEC: The Complete Guide to SSH Access
rm /storage/roms/gamelist.xml
emulationstation --create-gamelists
5. Overclocking the CPU (Hardware dependent)
First, check your current governor:
cat /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor
To set performance mode (max speed):
echo performance > /sys/devices/system/cpu/cpu0/cpufreq/scaling_governor
To make permanent, add that line to /storage/.config/autostart.sh.
6. Update via SSH (Manual Git Pull)
If the internal updater fails: Or, using the EmuELEC script:
/usr/bin/emustation
cd /tmp
wget https://github.com/EmuELEC/EmuELEC/releases/latest/EmuELEC-Amlogic-ng.aarch32-VERSION.img.gz
gunzip EmuELEC-*.img.gz
dd if=EmuELEC-*.img of=/dev/mmcblk1 bs=4M status=progress
Success Indicator
Once connected, you will see a welcome message showing the EmuELEC version and a prompt that looks like:
EmuELEC:~ #
You are now in the shell. Be careful—you have full root access.
Skip to content