DOSBox Setup Guide: DOSBox Staging, DOSBox-X and Handhelds

Last updated: October 2026

DOSBox is how almost everyone plays DOS games today. GOG and Steam ship most of their DOS catalogue wrapped in a copy of it. But the original DOSBox has barely moved in years, and the two forks that replaced it, DOSBox Staging and DOSBox-X, are better at nearly everything.

This guide covers which version to install, how to get a game running on Windows, the handful of settings that matter (speed, scaling, aspect ratio, sound), and how to take the same setup to a Steam Deck or an Android handheld. If you want a whole emulated PC with Windows 98 instead of a DOS box, that is a different tool: see the 86Box and PCem guide.

What You Need

DOSBox Staging vs DOSBox-X vs Original DOSBox

DOSBox Staging is the one I recommend for games. It ships with defaults that look and sound right out of the box: correct 4:3 aspect, automatic CRT shader selection, accurate Sound Blaster filtering, and NukedOPL for AdLib music. Version 0.83.0 added floppy and CD-ROM automounting and merged the MOUNT and IMGMOUNT commands.

DOSBox-X is the pick when you want to go beyond games: running Windows 3.1 or Windows 9x inside DOSBox, PC-98 software, or unusual hardware. It has a menu bar for settings, which some people prefer to editing a text file. It releases roughly monthly.

Original DOSBox still works, and GOG’s bundled builds often use it, but there is no reason to install it fresh in 2026.

Install on Windows

1. Go to dosbox-staging.org and download the Windows installer or the portable zip. For DOSBox-X, use the DOSBox-X site.
2. Install or unzip it.
3. Make a folder for your games, for example C:\DOS. Put each game in its own subfolder: C:\DOS\DOOM, C:\DOS\XCOM.

Launch DOSBox Staging once. It creates its config file at C:\Users\<you>\AppData\Local\DOSBox\dosbox-staging.conf. Open it in Notepad or any text editor when you need to change something.

Mounting a Folder as C:

DOSBox does not see your hard drive until you tell it which folder to treat as drive C:. At the Z:\> prompt, type:

mount c C:\DOS
c:
cd DOOM
doom.exe

That mounts C:\DOS as drive C:, switches to it, enters the game folder and starts the game. Type dir to list files if you are not sure what the program is called.

To skip typing this every time, add the same lines to the [autoexec] section at the bottom of the config file. They run on every launch.

CD-based games. If the game needs its CD, make an image of your own disc (ISO or CUE/BIN) and mount it as D:

imgmount d C:\DOS\images\game.cue -t iso

In DOSBox Staging 0.83, plain mount handles images too, and the new automount feature picks up floppy and CD images for you.

Games from GOG and Steam. These come with their own DOSBox build and a config file already set up. You can run the game files in Staging instead by pointing mount c at the game’s install folder and mounting its included disc image if it has one.

Config Basics: Cycles, Scaler and Aspect

Three settings fix most problems.

CPU cycles (game speed)

DOS games were written for specific CPU speeds. Too fast and older games become unplayable; too slow and later 3D games stutter.

DOSBox Staging splits this into two settings in the [cpu] section:

Start with the defaults. If an older game runs too fast, lower cpu_cycles. If a mid-90s game stutters, raise cpu_cycles_protected until it is smooth, staying within what your machine can sustain. In original DOSBox the single equivalent is cycles=, with auto or a fixed number.

Scaler and shaders

Original DOSBox used scaler= options such as normal2x. DOSBox Staging replaces this with GPU shaders and picks a CRT look automatically to match the emulated graphics card. If you prefer sharp pixels, switch the shader to a sharp or pixel-perfect option in the [render] section of the config. The manual on the Staging site lists the current names.

Aspect ratio

DOS games ran at resolutions like 320x200 on 4:3 monitors, so the pixels were taller than they were wide. Without correction, everything looks squashed. DOSBox Staging corrects aspect by default. In original DOSBox, set aspect=true in the [render] section.

Sound: Sound Blaster, MT-32 and General MIDI

Sound Blaster. DOSBox emulates a Sound Blaster 16 at address 220, IRQ 7, DMA 1 by default. When a game’s setup program asks, pick Sound Blaster (or Sound Blaster 16) with those values. For music, choose AdLib or Sound Blaster FM if the game has no MIDI option.

General MIDI. Many 90s games have far better music on a General MIDI device. DOSBox Staging includes FluidSynth, which plays General MIDI through a SoundFont file (.sf2). Put the SoundFont in the soundfonts folder inside the DOSBox config folder, set mididevice = fluidsynth and soundfont = yourfile.sf2, then select General MIDI in the game’s setup. Free, redistributable SoundFonts are available from their authors, such as GeneralUser GS.

Roland MT-32. Sierra and LucasArts games from the late 80s and early 90s were composed for the Roland MT-32. DOSBox Staging and DOSBox-X both emulate it, but the emulation needs firmware dumps taken from a real MT-32, and the projects cannot bundle them for copyright reasons. If you own the hardware, dump your own firmware files and place them in the MT-32 firmware folder inside the config folder (the DOSBox Staging manual gives its exact name), then set mididevice = mt32. If you do not, General MIDI through FluidSynth is the legal and easy route for most of these games.

Controllers

Most DOS games expect a keyboard, so the useful part of controller support is mapping buttons to keys.

• DOSBox Staging and DOSBox-X include a key mapper. Press Ctrl+F1 to open it, click a key on the on-screen keyboard, then press the controller button you want to bind. Save the mapping.
• Real joystick games (flight sims, some racers) read the DOS joystick port. Set joysticktype = auto in the [joystick] section and calibrate inside the game’s setup.
• Mice work automatically; click inside the window to capture the cursor.

For anything more complicated, tools like Steam Input (on Windows through Steam, or on the Steam Deck) let you remap a pad to keys system-wide.

DOSBox on a Steam Deck

Two good routes:

1. DOSBox Staging as a Flatpak. In Desktop Mode, open Discover, search for DOSBox Staging and install it. The config lives in ~/.var/app/io.github.dosbox-staging/config/dosbox/. Add it to Steam as a non-Steam game and use a Steam Input template that maps the Deck’s controls to keyboard keys.
2. RetroArch with the DOSBox Pure core. This is what you get through EmuDeck. DOSBox Pure loads games straight from .zip files, auto-mounts disc images inside the zip, and adds save states, rewind and an on-screen keyboard.

DOS games you own on Steam run on the Deck through Steam’s own compatibility layer, so check there before setting anything up.

DOSBox on Android Handhelds

DOSBox Staging and DOSBox-X do not have official Android builds. The practical option on an Android handheld such as the Retroid Pocket 5 is RetroArch with the DOSBox Pure core:

1. Install RetroArch (see the RetroArch setup guide).
2. In Online Updater > Core Downloader, download DOS (DOSBox Pure).
3. Zip each game folder and copy the zips to your device.
4. Load a zip with DOSBox Pure. On first launch it asks which executable to run and remembers your choice.

Use the core’s built-in controller mapping or on-screen keyboard for games that need typing. The touch screen works as a mouse, which helps with point-and-click adventures. For general Android emulator setup, see the Android emulation guide, and for picking a device, best handheld emulators.

FAQ

Is DOSBox legal?

Yes. DOSBox and its forks are free, open source software. You need your own copies of the games: buy them on GOG or Steam, or use your own original disks.

Which DOSBox should I use in 2026?

DOSBox Staging for games. DOSBox-X if you want Windows 3.x or 9x inside DOSBox, PC-98 software, or deep hardware options.

Why does my game run too fast or too slow?

That is the cycles setting. Lower cpu_cycles for older games that run too fast; raise cpu_cycles_protected for later games that stutter.

Can DOSBox run Windows 98?

DOSBox-X can, with your own install media. For an accurate period PC with real chipsets and 3D cards, use 86Box.

How do I get MT-32 music without the firmware files?

You cannot. MT-32 emulation requires firmware dumped from the hardware you own. Use General MIDI with a free SoundFont instead.

DOSBox Staging | DOSBox-X | DOSBox Pure

More retro computer guides: Commodore 64 emulator guide | Amiga emulator guide

Last verified: October 2026