How to Set Up DOSBox-X and Play Classic DOS Games — Complete Guide 2026

Why DOSBox-X (not the original DOSBox)

Use DOSBox-X instead of the original DOSBox 0.74-3 for all new setups. DOSBox-X is actively developed in 2026, includes a built-in graphical interface, supports save states, offers better Windows 9x emulation, and runs the same DOS games as the original. The original DOSBox 0.74-3 (bundled by GOG with older purchases) is legacy — DOSBox-X is a strict upgrade.

Step 1 — Download DOSBox-X

Go to dosbox-x.com → Releases and download the current version for your OS:

• Windows: Download the 64-bit installer or portable ZIP. Extract to a folder like C:\DOSBox-X\.
• macOS: Download the .dmg (Universal binary — Intel + Apple Silicon). Drag to Applications.
• Linux: Use the AppImage or sudo apt install dosbox-x on Debian/Ubuntu.

DOSBox-X is portable — you can run it from a USB drive without installing.

Step 2 — Organize Your DOS Games Folder

Create a folder for your DOS games, for example C:\DOS-Games\. Put each game in its own subfolder:

• C:\DOS-Games\Doom\
• C:\DOS-Games\Commander-Keen\
• C:\DOS-Games\Civilization\

Step 3 — Mount Your Game Folder and Run a Game

Launch DOSBox-X. At the Z:\> prompt:

1. Mount your games folder as the C: drive: mount c C:\DOS-Games
2. Switch to C: c:
3. Navigate to your game: cd Doom
4. List files: dir
5. Launch the main executable (usually .EXE or .BAT): DOOM.EXE

That is the core workflow for every DOS game. The mount command maps a real folder on your PC to a virtual DOS drive letter.

Where to Get DOS Games Legally

• GOG.com — the largest legal source; thousands of classic DOS games, cheap or free (Doom, Quake, Warcraft series, Civilization series). GOG bundles the original DOSBox, but you can extract the game files from the GOG installer and run them in DOSBox-X for a better experience.
• Internet Archive (archive.org/details/softwarelibrary_msdos) — thousands of freeware, shareware, and abandonware DOS titles you can download legally.
• Your own physical media — image your original floppies or CDs with ImgBurn or WinImage, then mount the image files in DOSBox-X.

Exit DOSBox-X: Press Alt+F4 or type exit at the prompt. To toggle mouse capture: F12+F. To toggle fullscreen: Alt+Enter.

CPU Speed — Cycles

DOS games were written for specific CPU speeds. DOSBox-X defaults to auto cycles, which works for most games. If a game runs too fast or too slow:

• Game runs too fast (Pac-Man, older 1980s games): Press Ctrl+F11 to decrease cycles. Try 3000–8000 cycles for 1980s games.
• Game runs too slow (Quake, late 1990s 3D games): Press Ctrl+F12 to increase cycles. Some late-DOS games need 50,000–100,000 cycles.
• Automatic mode: type cycles=max in the DOSBox-X config for maximum performance.

In DOSBox-X, go to DOS menu → Set CPU Speed to set cycles via the graphical interface instead of keyboard shortcuts.

Sound Blaster 16 Audio

DOSBox-X emulates a Sound Blaster 16 by default — the most common DOS audio standard. When a game's setup/install program asks for your sound card, choose:

• Sound card: Sound Blaster 16 (or Sound Blaster Pro / AWE32 if available)
• IRQ: 7 (DOSBox-X default)
• DMA: 1
• Port: 220

These values match DOSBox-X's emulated hardware. If no sound in a game, run its SETUP.EXE or INSTALL.EXE and confirm these settings.

OPL / MIDI Music

For FM synthesis music (the classic DOS "beeps and boops" of the 1990s), DOSBox-X emulates an OPL3 chip by default — authentic to original hardware. For MIDI-quality music (if a game offers "General MIDI" or "Roland MT-32"), DOSBox-X can use your Windows MIDI synthesizer: in the config file, set mididevice=win32 under [midi].

Display and Fullscreen

Toggle fullscreen with Alt+Enter. For sharp pixels (no blur) at any resolution: in the DOSBox-X config, set output=direct3d (Windows) or output=openglnb (macOS/Linux) under [sdl]. The nb suffix means "no bilinear filtering" — keeps pixels crisp for pixel-art DOS games.

The DOSBox-X Config File

DOSBox-X reads a config file at startup. The default config is at:

• Windows: %APPDATA%\DOSBox-X\dosbox-x.conf
• macOS/Linux: ~/.config/dosbox-x/dosbox-x.conf

Open this file in any text editor to set permanent options. Key sections:

• [autoexec] — commands that run at startup. Add mount c C:\DOS-Games and c: here so you never have to type it manually.
• [cpu] — set cycles=auto (default) or a fixed number like cycles=30000
• [sblaster] — confirm sbtype=sb16, irq=7, dma=1, port=220

Running GOG Games in DOSBox-X

GOG games come with the original DOSBox bundled, but DOSBox-X runs the same games better. To use DOSBox-X with a GOG game:

1. Find the GOG game folder (usually C:\GOG Games\[Game Name]\)
2. In DOSBox-X, mount the folder: mount c "C:\GOG Games\Doom"
3. Switch to C: and run the game executable

Alternatively, use GOG Galaxy → game settings → change the default DOSBox path to point to your DOSBox-X executable.

Windows 95/98 Emulation (Advanced)

DOSBox-X supports full Windows 9x emulation — you can run old Windows 95/98 software, games like Diablo, StarCraft, and Age of Empires in their original environment. This requires a Windows 9x disk image. DOSBox-X's wiki at dosbox-x.com/wiki/Guide%3AInstalling-Windows-95 has a step-by-step guide.

Keyboard Shortcuts Reference

• Alt+Enter — toggle fullscreen
• Ctrl+F12 — increase CPU cycles
• Ctrl+F11 — decrease CPU cycles
• F12+F — toggle mouse capture
• F12+R — reset DOSBox-X

Performance Tips

• Early 1980s games (Pac-Man, Frogger, early Sierra games): lower cycles to 3000–8000 to avoid instant-death from too-fast gameplay. Use Ctrl+F11 while the game is running to dial in the right speed.
• Late 1990s 3D games (Quake, Unreal): these push DOSBox-X hard. Set cycles=max for maximum speed, and use the VESA/SVGA graphics option when the game offers it.
• CD-ROM games: mount the ISO/CUE image instead of inserting a disc: imgmount d "C:\isos\GameName.iso" -t cdrom
• Multiple sound card configs: if a game has its own install/setup program, always run it inside DOSBox-X (not from Windows) so it writes the config files for the virtual DOS environment.

Common Issues

• Game says "Cannot find drive C:" or "Path not found": you forgot to mount. Add mount c C:\DOS-Games and c: to the [autoexec] section of the config file so it runs automatically at startup.
• No sound / music in a game: run the game's SETUP.EXE inside DOSBox-X and enter Sound Blaster 16 settings: port 220, IRQ 7, DMA 1.
• Game crashes with "This program requires Microsoft Windows": this is a Windows 95/98 era game, not a DOS game — it needs DOSBox-X's Windows 9x mode or a separate VM.
• Game too fast — enemies instant-kill / text flashes: press Ctrl+F11 to lower cycles to 3000–8000 for 1980s games.
• Game too slow / slideshow: press Ctrl+F12 repeatedly to increase cycles. For CPU-heavy late-DOS games, try cycles=max in the config.
• Mouse not working in game: press F12+M to toggle mouse capture. Some games need the mouse captured inside the DOSBox-X window.
• "This program cannot be run in DOS mode": this is a 32-bit Windows application, not a DOS program. It needs Windows, not DOSBox.
• Clone ROM needed (for MAME users using MAME inside DOSBox-X): not applicable — DOSBox-X is for DOS games; for arcade ROMs use MAME directly.

Cross-link: For classic adventure games (Monkey Island, King's Quest), ScummVM is a better choice than DOSBox — it reimplements the original game engines with quality-of-life improvements. For arcade games, see the MAME setup guide.