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.
The default credentials for EmuELEC are:
First login security: You will see a warning about the host key not being cached. Type yes to continue.
SSH turns EmuELEC from a simple launcher into a fully manageable retro Linux gaming system.
Whether you're a tinkerer, a dev, or just hate unplugging USB drives – this is a game changer.
Have you used SSH with EmuELEC yet?
Drop your favorite terminal trick below 👇
To connect to your EmuELEC device via SSH, you must first enable the service within the system settings and use the correct default credentials. 1. Enable SSH in EmuELEC
Before you can connect, the service must be active. If you are using EmuELEC as an add-on or within a dual-boot setup: Navigate to Settings > CoreELEC/EmuELEC > Services. Select Enable SSH.
If you cannot access settings due to a controller issue, you can connect a standard USB keyboard or mouse to navigate the menus. 2. Default Login Credentials
When prompted by your SSH client (like PuTTY on Windows or Terminal on macOS/Linux), use these default details: Username: root Password: emuelec
Note: If you are running EmuELEC through a CoreELEC base, the password might be coreelec. 3. Find Your Device IP Address
To establish the connection, you need the local IP address of your device: Go to Main Menu > Network Settings.
Note the number listed under IP Address (e.g., 192.168.1.50). 4. Connecting from Your Computer emuelec ssh
Windows: Open PuTTY, enter the IP address, ensure the port is set to 22, and click Open.
macOS/Linux: Open the Terminal and type:ssh root@your_device_ip Common Use Cases for SSH
File Management: Use an SFTP client like WinSCP to browse folders directly at /data/emuelec for ROMs or configuration edits.
System Controls: Stop the interface to perform updates or manual configurations using systemctl stop emustation.
Customization: Add custom templates or scripts by navigating to specific system directories. Using SSH & SCP to Add Custom Remarkable Templates
Using SSH with EmuELEC is the "power user" way to manage your retro gaming setup, offering a level of control that the standard UI simply can't match. The Setup Process
Connecting is straightforward but requires you to be on the same network. By default, EmuELEC has SSH enabled.
Credentials: You’ll use root as the username and emuelec as the password.
Connection: Using a client like PuTTY or Termius, you point to your device's local IP address. Why SSH is a Game Changer
While the Pixelcade guide highlights basic connectivity, the real value lies in backend management:
File Management: You can move ROMs and BIOS files directly into their specific system folders (e.g., Atari 2600, Mega Drive, or PC Engine) without constantly swapping SD cards.
Configuration Tweaks: You can manually edit .cfg files or script-level settings for emulators like Dolphin (Wii/GameCube) or PPSSPP (PSP) that might be buried in the standard menus.
System Recovery: If the EmulationStation UI freezes, an SSH terminal allows you to reboot the system gracefully or kill specific processes without pulling the power plug, which protects your SD card from corruption. Performance & Limitations
SSH is incredibly lightweight; it won't impact your gaming performance while running in the background. However, it is strictly a text-based interface. If you prefer a visual folder structure, using SFTP (Secure File Transfer Protocol) through a tool like WinSCP or FileZilla uses the same SSH credentials but provides a drag-and-drop interface for your ROM library. Final Verdict Default SSH credentials commonly used by EmuELEC builds:
If you are serious about customizing your EmuELEC device—whether it's an Odroid or a generic Android box—mastering SSH is essential. It turns a closed gaming console into a flexible, manageable Linux computer. Pixelcade for EmuELEC
The room was dark, save for the cold blue glow of a 55-inch television screen. Leo sat on the edge of the couch, controller in hand, staring at a blinking cursor. He wasn't playing a game; he was stuck in the menu of his newly acquired Android TV box.
He had bought the generic black box online for one purpose: to turn it into an all-in-one retro gaming console. He had flashed the SD card with EmuELEC, the standalone operating system that transformed cheap hardware into a retro-gaming powerhouse. But something was wrong. The system had booted, but the controller—the weapon of choice for his digital conquests—refused to sync. He was locked out of his own kingdom.
Leo put the controller down and sighed. He could reinstall everything, spending another two hours copying ROMs, but he was impatient. He reached for his laptop perched on the coffee table and flipped it open.
"Time to go in through the back door," he muttered.
He opened the terminal. The screen was black text on a white background, the digital equivalent of a surgeon's scalpel.
He typed the incantation: ssh root@192.168.1.45.
The laptop paused, searching for the device. The TV screen flickered in the background. A prompt appeared on the laptop: Are you sure you want to continue connecting?
Leo typed yes and hit enter. Then came the password. For EmuELEC, the default was always the same. He typed emuelec.
Access granted.
Suddenly, the TV screen didn't matter anymore. The graphical interface—the pretty pictures of cartridge art and swirling menus—was gone for him. He was now inside the machine. He had bypassed the broken controller interface and was speaking directly to the Linux kernel that ran the show.
He typed ls to list the directories. The familiar architecture of the system scrolled down his laptop screen: roms, bios, configs. It was a digital fortress, and he now held the keys to every door.
He navigated to the configuration folder, his fingers dancing across the keyboard. He wasn't just a gamer anymore; he was an architect. He needed to manually edit the input configuration file to force the system to recognize his Bluetooth adapter.
nano /storage/.config/emulationstation/es_input.cfg EmuELEC has established itself as the gold standard
A text editor opened up. It looked like the Matrix—lines of code defining buttons, axes, and device IDs. He found the error: a mismatched device path. He carefully corrected the string of text, his heart beating a little faster. One wrong character here could corrupt the whole setup.
He saved the file (Ctrl+O, Enter) and exited (Ctrl+X).
"Reboot," he whispered to the machine.
He typed reboot.
The TV screen went black. The terminal on his laptop disconnected with a polite Connection closed by foreign host.
Leo watched the TV. The EmuELEC logo flashed—the familiar gamepad symbol rotating in 3D space. The boot sequence scrolled by. Then, the main menu appeared.
He picked up the controller. He hesitated for a second, then pressed the 'A' button.
The menu highlighted "Games."
It worked.
Leo smiled. The console was no longer just a pre-packaged toy; it was his. He had tunneled in through SSH, fixed the broken bone, and stitched it back up. He closed the laptop, picked up the controller, and finally pressed Start. The legend of Zelda began to play, but tonight, the real game had been the code itself.
reboot
To access your system via SSH, you can connect from any computer on the same network to manage files, update scripts, or rotate your screen display. 🛠️ Quick Connection Guide Default Username Default Password Connection Command ssh root@
partition to manually backup saves or edit configuration files without removing the SD card. Security Tip
: It is highly recommended to change your root password after the first login using the command to keep your device secure on your local network. Are you looking to automate a specific task troubleshoot a connection error with your EmuELEC setup? Pixelcade for EmuELEC
Most users rely on the standard EmuELEC interface or Samba shares (network drives) to manage their ROMs and BIOS files. However, SSH provides root-level access to the underlying Linux operating system. Here is what you can do with SSH that you cannot do via the GUI:
If you have network access but no input device: