Skip to content
screenshot of the computer game Flight of the Amazon Queen (DOS version)
screenshot of the computer game Flight of the Amazon Queen (DOS version) Image by Interactive Binary Illusions, Steve Stamatiadis, John Passfield,, via Wikimedia Commons (Public domain).

DOSBox

DOS EMULATOR CORE

DOSBox

Libretro cores that run DOS games using DOSBox code (commonly distributed as dosbox, dosbox_core, and DOSBox-Pure cores) for use with RetroArch and other libretro frontends.

DOSPRIMARY SYSTEM
2002PROJECT BEGAN
Open sourcePROJECT MODEL

WHY IT MATTERS

Why use the libretro DOSBox cores?

They provide a DOS emulation experience integrated into libretro frontends (RetroArch and compatibles), including core-specific settings, centralized core/download management and the ability to run DOS games alongside other console/PC cores in one frontend.

BEST FOR

Strengths

Integrates with RetroArch's core downloader and settings; can use RetroArch input, save-state, and shader features; multiple cores (dosbox_core / DOSBox-Pure / dosbox-core forks) offer different tradeoffs (traditional DOSBox behavior vs a turnkey, game-focused Pure fork).

Prince of Persia gameplay on DOS
Gameplay from Prince of Persia on DOS.

The people behind DOSBox

History and status

DOSBox is a long-running open-source DOS emulator that originated in 2002. Several libretro cores wrap or fork DOSBox code to run as plugins for RetroArch. libretro maintains documentation pages for the DOSBox cores and the libretro core list identifies multiple DOS-related cores (dosbox, dosbox-core, DOSBox-Pure). Individual core repositories, packaging and maintenance are handled by different authors — for example community-maintained projects such as realnc/dosbox-core and the DOSBox-Pure project work toward features and UX specific to libretro. These cores are actively distributed through RetroArch's core downloader and via build repositories; development activity varies by core and fork. DOSBox itself and the libretro cores do not ship commercial games, BIOS/firmware, or proprietary files — those must be provided by the user when required by a game or configuration.

What DOSBox supports

  • RetroArch and other libretro frontends
  • Host OSes where RetroArch and the chosen core are built and distributed (commonly Windows, Linux, macOS, Android — availability depends on the core build/packaging)
  • DOS game disk images and directories mounted as drives via core/RetroArch configuration
  • Standard DOSBox config options via per-core config or generated config files

Download and availability

OFFICIAL DOWNLOADS

Get DOSBox

Install via RetroArch's Core Updater where available (recommended). Manual downloads are provided from the cores' source repositories or packaged distributions; use official libretro/docs pages and the core's repository for authoritative release artifacts.

Get DOSBox ↗

DOCUMENTATION

Official documentation

Read the official configuration, compatibility, and troubleshooting material before changing advanced options.

Read official documentation ↗
Broken or missing download? Emulator projects move and official links sometimes change. Please contact Retro Replay so the source can be verified and updated.

DOSBox setup guide

Setup note: This guide explains how to obtain and run a libretro DOSBox core (dosbox / dosbox_core / DOSBox-Pure) in RetroArch, prepare DOS game content, and configure common settings. Follow core-specific docs for advanced features.

  1. 1) Choose and install a core: Open RetroArch, go to Online Updater (or Core Updater) and select a DOSBox-related core (named dosbox, dosbox_core, or DOSBox-Pure depending on your RetroArch build). If your platform or build does not provide the core via the updater, fetch the core binary from the core's official source repository or your distribution's package (consult the core's README). Place the core binary (.so/.dll/.dylib/.wasm as appropriate) into RetroArch's cores directory and refresh RetroArch.
  2. 2) Prepare your DOS content: Obtain the game files legally. For most DOS games you will either point the core at a folder containing the game's files, a disk image (IMG, ISO), or an executable. Do not expect the core to include commercial game files or BIOS; provide them yourself when required.
  3. 3) Generating or placing a DOSBox config: Many libretro DOSBox cores use a per-core config directory under RetroArch's system or config directories. You can let the core generate a default config by launching the core and then using the core's built-in command (docs.libretro.com notes how to generate and save a config), or create a dosbox.conf-style file in the core/system directory. Consult the specific core docs for where the core looks for its config file.
  4. 4) Mounting drives and launching a game: In RetroArch you can either: (A) Load Core, then Load Content — selecting the game's executable or image; or (B) from a shell/CLI run retroarch -L /path/to/core "path/to/game". Within the running core, use DOSBox-style commands (such as MOUNT C /path/to/game) if the core exposes the DOS prompt, or rely on the core to auto-mount content if it supports automatic mounting (behavior differs by core).
  5. 5) MIDI, sound and OPL configuration: Cores may expose options for MIDI backend, OPL emulation and MT-32. Configure these via the RetroArch Quick Menu -> Options while a core is loaded, or by editing the core's config file. If you require external MIDI routing or MT-32 ROMs, provide them yourself and follow the core's documentation for specifying paths.
  6. 6) Save states, input and performance: Use RetroArch features (save states, input mapping, shaders) normally. For CPU/cycle tuning and timing-sensitive games, adjust core-specific cycle or CPU options in the Quick Menu or config; consult the core docs because behavior and option names vary between dosbox_core, dosbox-pure and other forks.
  7. 7) Advanced: manual core installation and config locations: If installing cores manually, place core files in RetroArch's configured cores directory and copy any example config files from the core repository into RetroArch's system/config directories. Check the core's repository for any required extra files or .info entries (some distros include a .info file listing supported extensions and checksums).

Software reminder: Cores do not include commercial DOS games, proprietary BIOS images, or MT-32 ROMs. Obtain those legally if a game requires them.

Sources and further reading

Detailed guides and tutorials

Explore step-by-step guides for DOSBox as they are published.

Use DOSBox on Android

An Android ARM64 Libretro build exists for DOSBox. Run the core through RetroArch for Android; the standalone desktop download and Android core may have different menus and features.

Emulates: DOS.

Verified Android core build ↗ · Browse all Android emulators →