# RetroArch

RetroArch is a frontend for emulators, game engines and media players. It is open source and self-hosted, installable on Docker Hub, Unraid and ZimaOS.

Canonical page: https://ourlocalhost.com/app/1539/retroarch

## Description

RetroArch is a frontend for emulators, game engines and media players. It lets you run classic games on a wide range of computers and consoles from one slick graphical interface, with a swappable core system for each console.

## Platform availability

Available on 2 of 10 platforms: Unraid, ZimaOS.

## Health score

73/100 (Good), based on 5 of 5 factors.
- Maintained: 100 (last commit 20 days ago)
- Popular: 26 (19 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Light to run: 100 (32 MB minimum RAM, runs on ARM)
- Security check: 85 (no serious findings, CI)

## Links

- Documentation: https://docs.libretro.com/
- Docker Hub: https://hub.docker.com/r/linuxserver/retroarch
- GitHub: https://github.com/linuxserver/docker-retroarch
- Official website: https://retroarch.com/
- Unraid: https://ca.unraid.net/apps/retroarch-0525k880d38nj8?q=retroarch
- ZimaOS: https://github.com/bigbeartechworld/big-bear-casaos/tree/master/Apps/retroarch

## Common questions

### Can multiple input actions be mapped to one controller button in RetroArch?

No, RetroArch lacks the ability to map multiple actions to a single button. If that behavior appears, the issue is often an external program intercepting gamepad events and triggering keyboard events.

### Can self-hosted RetroArch netplay use a private relay instead of the public one?

A guide describes using RetroArch's host/client model and running your own relay for LAN and WAN netplay instead of Libretro's public relay. It also covers which cores sync reliably and the input-delay versus rollback tradeoff.

### How are user permissions configured in the linuxserver RetroArch Docker image?

The image supports easy user mappings using PUID and PGID.

### Can original CD discs be played directly in RetroArch?

Yes, RetroArch can run original game discs, including CDs.

## Alternatives

- Chimera: Chimera is a web app for remotely installing non-Steam software to your Linux based couch gaming system.
- CrossOver: Install Windows applications on Mac, Linux, and Chrome OS without needing a Windows license, offering seamless integration and easy app man…
- DuckStation: DuckStation is a PlayStation 1 (PS1) console emulator that prioritises high accuracy and broad game support.
- Lakka: Lakka is the official Linux distribution of RetroArch and the libretro ecosystem.
- Lemuroid: Lemuroid is an open-source emulation project based on Libretro.
- Mame: MAME is a free and open-source emulator that recreates arcade games, consoles, old computers, and other systems in software, packaged by Li…
- OpenEmu: Open Emu is an open source project to bring game emulation to OS X as a first class citizen, leveraging modern OS X technologies such as Co…
- PPSSPP: PPSSPP is a free and open-source PlayStation Portable (PSP) emulator focused on speed and portability.
- PlayOnLinux - PlayOnMac: PlayOnLinux is a graphical frontend for the Wine software compatibility layer which allows Linux and Mac users to install Windows-based vid…
- ScummVM: ScummVM is a cross-platform interpreter, not an emulator, that runs classic graphical adventure and role-playing games by replacing their o…
- VisualBoyAdvance: VisualBoyAdvance (VBA) is a free software (GNU GPL) emulator targeted for the Game Boy, Super Game Boy, Game Boy Color, and Game Boy Advanc…
- mGBA: mGBA is an open source emulator of the Game Boy Advance.

---
Source: Our Local Host (https://ourlocalhost.com/app/1539/retroarch), the self-hosted and open-source app directory.
