v2.0.2 — Docker flow refreshed

Elevate Your Retro Experience.

A retro-styled web control center for Batocera Linux. Manage ROMs, monitor live stats, browse files, open a secured terminal, and deploy it your way: Remote, Docker, or Native.

Get Started Source Code
Quick Install git clone https://github.com/DavidSchuchert/Batocera-WebDashboard-Pro.git && cd Batocera-WebDashboard-Pro && ./install.sh

System Dashboard

Dashboard — live CPU/RAM/Temp stats
5,000+ Games supported
2s Live stats refresh
3 Deploy modes
82+ Automated tests
MIT Free & open source

The Arsenal

ROM Library

Browse up to 5,000 games with cover art, developer info, and descriptions from gamelist.xml. Instant multi-word search across all systems.

Live Stats

Real-time monitoring of CPU, RAM, and temperature via Server-Sent Events — updated every 2 seconds without polling.

Emulator Config

Edit emulator settings and batocera.conf directly in the browser. Shaders, video modes, per-system options.

File Manager

Upload ROMs, download saves, and delete files inside /userdata. Native uploads are fixed in v2.0.2, with traversal attempts blocked outside the safe path.

Terminal

Shell access right in your browser. Dangerous commands (rm -rf /, mkfs, fork bombs) are blocked by an allowlist.

Live Logs

Stream EmulationStation, boot, and syslog output in real time. Switch sources without leaving the page.

Mobile Ready

Fully responsive layout — works on phone, tablet, and desktop. Control your console from the couch.

Quick Control

Stop a running game, adjust volume, reboot, or shut down your console with a single button press.

Choose Your Mode

Remote

Run on your Mac or PC and manage Batocera over SSH. The installer auto-detects your setup and keeps Remote mode lightweight for local network control.

git clone https://github.com/DavidSchuchert/Batocera-WebDashboard-Pro.git cd Batocera-WebDashboard-Pro && ./install.sh

Access: http://localhost:8989

Docker

Run Remote mode in a container on your Mac, PC, or server. No local Python dependency setup required, and v2.0.2 refreshes the setup and update flow.

cp docker/.env.example docker/.env docker compose --env-file docker/.env --project-directory docker -f docker/docker-compose.yml up -d

Set BATOCERA_HOST, BATOCERA_USER, and BATOCERA_PASS in docker/.env.

Access: http://localhost:8080

Native

Installs directly on Batocera and starts automatically on boot. The installer pushes everything via SSH from your Mac/PC, with v2.0.2 fixing uploads inside /userdata.

# Pick "Native" in the installer and enter # your Batocera's IP — that's it.

Access: http://batocera.local:8989

The installer auto-detects your OS (Batocera, macOS, Linux, WSL, Git Bash), lets you choose Remote, Docker, or Native interactively, and updates all modes with ./install.sh --update. Force Docker updates with BATOCERA_MODE=docker ./install.sh --update. Full install guide →

See It In Action

Full Walkthrough

Dashboard walkthrough animation

ROM Library

ROM Library with cover art and metadata

Game Detail

Game detail — developer, description, year

File Manager

File Manager — browse, upload, download

Config Editor

Emulator Config editor

Terminal

Built-in terminal with command security

Mobile View

Mobile view on iPhone

Cover art shown is placeholder art generated from game metadata. On a real Batocera system, Scraper automatically downloads official cover art from ScreenScraper or TheGamesDB into your /userdata/roms/*/images/ folders.