Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Some links on this page are affiliate links: if you buy through them we may earn a commission, at no extra cost to you.

For most new Linux setups, DOSBox Staging is the best place to start: it is a modern continuation of DOSBox, and its official Linux page lists version 0.82.2 as the current stable release as of September 23, 2026. Install it from the official x86_64 archive, use a Flatpak, or install your distribution’s dosbox package. Then mount a Linux folder inside DOSBox as a virtual drive, change to that drive, and run the game’s actual DOS executable.

DOSBox emulates an x86 PC and DOS environment; it does not install MS-DOS or automatically find files on your Linux system. The key is mounting only the folder that contains software you have the right to use.

Before you begin

Use a Linux desktop with working graphics and audio, and have a legally obtained DOS game or program ready. Copyright rules vary by software and jurisdiction; a title being old or described as “abandonware” does not by itself make it free to download.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Create a dedicated folder in your home directory. For example:

#1 Best Overall
Sale
Logitech G F310 Wired Gamepad Controller Console - Blue/Black
  • With broad game support, the Logitech Gamepad F310 works with old standbys to today's biggest titles, so it's easy to set up and use with your favorite games.
  • Profiler software allows the gamepad to be programmed to perform keyboard and mouse commands for games without gamepad support.* * Requires software installation.
  • A familiar control layout that doesn't require a learning curve to be able to use, with all the same buttons as on an Xbox 360.
  • The unique floating D-pad rests on four switches-instead of a single pivot point-making it responsive to quick changes in direction.
  • The six-foot cord lets you lean back and play a comfortable distance from your PC monitor.
mkdir -p "$HOME/DOSGames/DOOM"

Copy or extract the game files into the appropriate folder. For your first setup, keep directory names simple and avoid spaces. Do not put game files in /usr or /opt; those are system locations and can introduce unnecessary permission problems.

Choose a DOSBox version

Version Best for What to know
DOSBox Staging Most new users A current continuation of DOSBox, intended as a mostly drop-in replacement. The official Linux archive currently targets x86_64 and requires an x86 processor with SSSE3. Check the release page for current requirements.
Original DOSBox Older tutorials, distro packages, or launchers that expect dosbox Widely packaged and familiar, but old instructions may refer to version-specific settings or configuration paths. Its official manual is for version 0.74-3.
DOSBox-X Advanced or unusual emulation needs Offers more detailed hardware and system controls. Its extra options can be unnecessary for a simple game setup, and Flatpak users may need to grant filesystem access.

Original DOSBox, Staging, and DOSBox-X are separate variants; “DOSBox” does not mean one identical release or configuration. For a general setup, start with Staging and try another variant only if a particular program needs it.

Install DOSBox Staging

Option 1: Use the official Linux archive

The project recommends its official Linux build over repackaged or self-compiled builds, especially for beginners. The archive is a portable, per-user option, not a system-wide installation.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Open the official Linux release page and download the current stable Linux x86_64 archive.
  2. In a terminal, go to the directory where it downloaded, usually ~/Downloads, and extract it. The archive’s exact filename and extracted folder can change, so check the names shown on your system.
cd "$HOME/Downloads"
tar -xf dosbox-staging-*.tar.*

Find the executable in the extracted directory:

cd dosbox-staging-*
find . -maxdepth 2 -type f -executable -print

Run the executable name included in the archive. If it is named dosbox-staging, for example:

./dosbox-staging

If you want to keep the extracted program in a per-user applications folder, you can move it there. Adjust the source path if you are not in Downloads:

mkdir -p "$HOME/Applications"
mv "$HOME/Downloads"/dosbox-staging-* "$HOME/Applications/"

This simply stores the program in your home directory; it does not install it for every user. The project’s Linux page also describes an included install-icons.sh script for users who want application icons.

Option 2: Install Staging with Flatpak

If Flatpak and the Flathub remote are available on your system, install and launch the official Flathub app using its application ID:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
flatpak install flathub io.github.dosbox-staging
flatpak run io.github.dosbox-staging

Flatpak apps are sandboxed, so Staging may not be able to see your game folder until you grant access. After creating ~/DOSGames, allow access only to that folder:

flatpak override --user 
  --filesystem="$HOME/DOSGames" 
  io.github.dosbox-staging

Close and reopen the emulator after changing the permission. The Flathub listing identifies the app and its application ID.

Rank #2
PowerA Wired Controller for Xbox Series X|S - blue, gamepad, video game/gaming controller, works with Xbox One, Officially Licensed
  • Featuring a bright, bold, unmistakable blue design
  • Dual Rumble Motors - Take your gaming experience to the next level, providing tactile feedback and sensations that bring your virtual worlds to life.
  • Immersive Impulse Triggers – provides haptic feedback sensations using built-in motors so you can feel the action of the game.*
  • Extra Long USB-C Cable - Provides you with 10 ft. of distance for more comfort and flexibility than shorter cables.
  • Ergonomic Design – Lightweight and comfortable for long gaming sessions.

Install your distribution’s DOSBox package

A repository package is convenient and integrates with your Linux distribution, but the package named dosbox is not necessarily DOSBox Staging. Package availability and version vary by distribution and release.

Debian, Ubuntu, and Linux Mint

sudo apt update
sudo apt install dosbox

Fedora-based distributions

sudo dnf install dosbox

Availability depends on your Fedora release and enabled repositories.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Arch Linux

sudo pacman -S dosbox

Arch’s DOSBox documentation also lists Staging and DOSBox-X alternatives; availability and packaging routes differ.

Check which command is installed and, where supported, its version:

command -v dosbox
command -v dosbox-staging
dosbox --version
dosbox-staging --version

Not every command will exist on every setup. A manually extracted archive or Flatpak may be launched differently; use the command or application ID for the option you installed.

Mount a Linux folder as a DOS drive

DOSBox does not automatically browse your Linux filesystem. You must explicitly map a Linux directory to a virtual DOS drive. If your game is in /home/alex/DOSGames, enter these commands at the DOSBox prompt:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
mount c /home/alex/DOSGames
c:
dir

Replace /home/alex with the real path to your home directory. The Linux path is used in mount; after the mount, navigate with DOS drive letters and commands. The C: you see inside the emulator is virtual—it is not your Linux root directory or a Windows disk. The original DOSBox manual documents mounting a Linux directory this way.

You can also start DOSBox from a terminal and queue the mount and drive-change commands. For the distribution command:

dosbox -c "mount c $HOME/DOSGames" -c "c:"

For a Staging executable available on your PATH:

dosbox-staging 
  -c "mount c $HOME/DOSGames" 
  -c "c:"

If you downloaded the portable archive, run its executable by the path you found, such as ./dosbox-staging, with the same -c options. These shell examples use $HOME to expand your home path; if a directory name contains spaces, quote and test the full mount command carefully.

Rank #3
abxylute C6 Wireless PC Controller, Bluetooth Game Controller -1000Hz Polling Rate- Hall Effect Joystick for Windows PC, Switch 1&2, Steam Deck, Android TV/Mobile, iOS, MAC &Tesla Vibration Turbo Lightweight
  • Wide Compatibility - The 1000Hz wireless gamepad controller works seamlessly with PC /Laptop (Windows 7 8 10 11, Xbox Games on PC, Not for Win XP), Android 8.0+ (cellphone, tablet, Smart TV, Samsung TV), for Apple / iOS 13 Above (iPhone, iPad), Mac, MacOS, Switch (Switch, Switch 2), Steam OS/Steam Deck, Tesla (Tesla Model 3 & Model Y) & Xbox Games on PC. Connectivity modes: 1. Wired, 2.Bluetooth Dongle (Not 2.4G), 3. Bluetooth wireless
  • Dual Hall Effect Joysticks and Triggers - Experience unparalleled precision and durability with Hall Effect Controller joysticks and triggers. Enjoy no drifting, no dead zones, and precise control with joysticks that offer an extended lifespan. The triggers provide glitch-free, responsive performance, reducing wear and tear, making this gaming controller ideal for competitive gaming
  • Ultra-Sensitive Response - The Rechargeable Wireless Gaming Controller achieves 1000H Hz in wired mode & Bluetooth Dongle mode, ensuring precise and prompt responses for seamless gaming, minimizing input lag for a competitive edge.
  • 4-Level Vibration & Gyro in Switch - From intense rumble at 100% to a gentle buzz at 30%, the abxylute gaming controller allows you to find the perfect level of immersion for every gaming session. Gyroscope can be available in Switch games, and motion sensing. 【Notice】One-Year after sales warranty.
  • Dual Turbo Modes & Long-lasting Gameplay - Customize turbo feature to any button, allowing you to unleash rapid-fire attacks with just a single press. Free your fingers and dominate your opponents effortlessly. The rechargeable wireless PC controller features a powerful 600mAh rechargeable battery, delivering up to 18 hours of continuous gameplay on a single charge. This ensures that you can enjoy uninterrupted gaming sessions with your controller for PC

Find and launch the right program

Suppose the game’s files are in ~/DOSGames/DOOM, while the parent ~/DOSGames is mounted as C:. At the DOSBox prompt, inspect the contents and then enter the game folder:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
c:
dir
cd DOOM
dir

Look at the filenames and run the program’s actual launcher. If the listing contains DOOM.EXE, enter:

doom.exe

Some titles start from a .COM file, a .BAT file, or a differently named executable. Do not assume every game starts with game.exe; check the files, read any included instructions, or look for a setup program.

For a game already installed in its own folder, you can mount that folder directly and start its executable. This example works only if doom.exe is actually in the mounted directory:

dosbox 
  -c "mount c $HOME/DOSGames/DOOM" 
  -c "c:" 
  -c "doom.exe"

Substitute dosbox-staging or the path to the archive’s executable if that is what you installed. Some DOSBox variants also accept a directory as a startup argument, for example dosbox "$HOME/DOSGames/DOOM", but the explicit mount commands make it clear what is being mapped and are easier to troubleshoot. See the Ubuntu DOSBox manual page for its directory-argument behavior.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Install a game from an installer

If you have an installer directory rather than an already-installed game, mount the directory containing the installer as another DOS drive. For example, if the installer files are in ~/Downloads/DOOM_INSTALL:

mount c /home/alex/DOSGames
c:
mkdir DOOM
mount d /home/alex/Downloads/DOOM_INSTALL
d:
dir

Run the installer that is actually present—perhaps install.exe, setup.exe, or a batch file. Follow its prompts and, when asked for a destination, choose a path on the mounted DOS drive, such as C:DOOM. The installer’s name and steps depend on the game.

A CD-based installer or a disk image is different from an ordinary folder. An ISO, floppy image, and hard-disk image are not interchangeable with a directory mount; the appropriate image-mount command and options depend on the image type and DOSBox variant. Some games also rely on CD audio or copy-protection behavior that may not be reproduced by a simple folder mount. Consult the documentation for your emulator and image format rather than treating every image as a folder.

Make mounting automatic

If you use the same DOSBox setup often, you can put mount commands in the configuration file’s [autoexec] section. A global mount for the games directory might look like this:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
GameSir T7 Wired Controller with Hall Effect Joysticks, Plug and Play Gaming Gamepad for Xbox Series X|S, Xbox One, Windows 10/11 & Steam, 3.5mm Audio Jack
  • Anti-drift Hall Effect sticks: Using GameSir non-contact magnetic Hall Effect technology to ensure the sticks never wear down in their lifetime and provide an ultra lifespan of up to 5 million cycles, GameSir T7 prevents stick drift and secures reliable, durable stick performance for gaming on Xbox, PC and Steam.
  • Precision-tuned Hall effect analog triggers: With precision-tuned Hall Effect triggers for a consistent, smooth pull, get ready to race with confidence and enjoy a seamless gaming experience like never before.
  • Realistic and subtle vibration: The controller features a total of four rumble motors, with one motor in each grip and trigger, providing immersive and realistic vibration feedback. Additionally, the two asymmetric actuators in the grips enhance the realism of the vibrations, ensuring that every small crash and shot is felt in your hands as if it were happening on the spot.
  • Comfort Ergonomic Design and textured surface: The ergonomic design, combined with the delicate laser-textured surface on the grips, bumpers, and triggers, ensures a secure hold and provides a comfortable, stable grip, even during extended gaming sessions.
  • 3.5mm headphone jack: The 3.5mm audio jack allows easy headset connection for immersive sound and clear communication.
[autoexec]
mount c /home/alex/DOSGames
c:

For a single game, mount its folder instead and optionally start its program:

[autoexec]
mount c /home/alex/DOSGames/DOOM
c:
doom.exe

Replace the example home path and executable with your own. Per-game configurations are usually better than changing global settings: a speed, sound, or drive setting that helps one title can cause trouble for another.

Find the configuration file

For a native DOSBox Staging installation, ask the program for its active configuration path:

dosbox-staging --printconf

The project documents this option and the native Linux configuration location, commonly ~/.config/dosbox/dosbox-staging.conf. The active path can vary with packaging, so use the program’s output rather than assuming that every build uses the same file. See the Staging getting-started guide.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Original DOSBox creates a configuration under ~/.dosbox/ on first run, but the filename depends on the version. Locate it rather than guessing:

find "$HOME/.dosbox" -maxdepth 1 -type f -print

Flatpak uses an application sandbox and may keep configuration under an application-specific location such as ~/.var/app/io.github.dosbox-staging/config/dosbox/. That path is not universal; use the installed variant’s configuration-printing option if available, or inspect the app-specific directory. If edits seem to have no effect, verify that you changed the active file and restart the emulator.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Fix common problems

The game runs too fast

Start with the emulator’s default settings before changing CPU speed. If the game still runs too quickly, reduce emulated cycles with Ctrl+F11, or try this command at the DOSBox prompt:

cycles 3000

3000 is an example, not a universal answer. The right value depends on the game and DOSBox variant. In original DOSBox, the configuration setting is written as cycles=3000; do not assume that original DOSBox options or names map directly to Staging or DOSBox-X. The original configuration guide explains cycle modes and cautions that excessive cycles can make games too fast or unstable and can cause audio stutter.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The game runs too slowly

Try increasing cycles with Ctrl+F12, but stop if the game becomes unstable or sound starts stuttering. If it remains slow, test without sound, reduce or disable expensive scaling, and check whether the game is using a high-resolution or protected-mode setup. More cycles do not guarantee better performance.

Best Value
GameSir G7 SE Wired Controller for Xbox Series X|S, Xbox One & Windows 10/11, Plug and Play Gaming Gamepad with Hall Effect Joysticks/Hall Trigger, 3.5mm Audio Jack (Orange)
  • Versatile Compatibility: Supports Xbox Series X/S, Xbox One X/S consoles, and PC Win10 and above (including the Steam game platform).
  • Precise Control: Features Hall Joysticks and Hall trigger for comfortable feel, long life, and enhanced gaming accuracy.
  • Plug-and-Play Convenience: USB wired connection (detachable) for easy setup and instant gaming without the need for additional drivers.
  • Customizable Experience: Includes 2 custom back keys, allowing users to eliminate false triggers and enhance their gaming experience.
  • Immersive Gameplay: Offers pulse type vibration trigger motor and asymmetric vibration grip motor for immersive tactile feedback.

There is no sound

If the game has a setup utility, run it and choose a sound device supported by your emulator. Older games commonly offer Sound Blaster-compatible choices, but the correct IRQ, DMA, and address are game-specific; do not assume one set of values will work for every title. To isolate the problem, test with sound disabled in the DOSBox configuration. The DOSBox manual recommends disabling sound as a troubleshooting test.

DOSBox cannot find the game or its files

At the DOSBox prompt, check the mounted drives and directory contents:

mount
c:
dir
cd GAME
dir

Confirm that you mounted the correct Linux folder, that the game is not one directory deeper than expected, and that you are using the DOS-visible filename shown by dir. If you use Flatpak, check its filesystem permission. If the program expects a CD or disk image, mounting its files as an ordinary folder may not be enough. Also make sure your Linux account can read the files.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A Flatpak cannot see the game folder

Grant access to only the games directory, then restart the app. For Staging:

flatpak override --user 
  --filesystem="$HOME/DOSGames" 
  io.github.dosbox-staging

For DOSBox-X:

flatpak override --user 
  --filesystem="$HOME/DOSGames" 
  com.dosbox_x.DOSBox-X

This is preferable to granting broad access to your entire home directory. DOSBox-X’s installation instructions also warn that Flatpak sandboxing can limit access to host files.

Configuration changes do nothing

Check that you edited the active configuration for the variant you are running, not another DOSBox fork’s file. Flatpak and native installations can use different configuration locations; a per-game configuration can also override global settings. Confirm the filename, check whether the setting is supported by that variant, save the file, and restart the emulator. For Staging, use dosbox-staging --printconf to identify its configuration path.

Useful commands and controls

Task Command or shortcut
List files dir
Change directory or drive cd foldername or c:
See mounted drives mount
Mount a Linux directory mount c /path/to/folder
Check DOSBox memory or DOS version mem or ver
Show DOSBox help help
Exit DOSBox exit
Toggle fullscreen in original DOSBox Alt+Enter
Adjust cycles in original DOSBox Ctrl+F11 to decrease; Ctrl+F12 to increase

Shortcuts can differ by variant or configuration, so consult the documentation for your installed build if one does not work. The original DOSBox setup guide describes common fullscreen and performance controls.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

When to try another emulator

If a program does not work in Staging, try the original DOSBox when a launcher or old guide specifically expects it, or when you need to compare behavior with a legacy setup. Consider DOSBox-X if the software needs unusual video, sound, memory, or peripheral settings and you want more control. Its official Flatpak installation commands are:

flatpak install flathub com.dosbox_x.DOSBox-X
flatpak run com.dosbox_x.DOSBox-X

Grant it access to your game folder with the DOSBox-X application ID as shown in the troubleshooting section. DOSBox-X’s broader controls can help with edge cases, but add complexity. None of these emulators guarantees compatibility with every DOS title.

DOSBox is for DOS-era software, not ordinary modern Windows programs. A Windows installer may need a different compatibility tool unless it includes a DOSBox setup. A frontend can manage shortcuts and per-game settings for a large library, but for one or two games, direct commands are simpler and make the mount-and-launch process easier to understand.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.