DOSBox · Windows

DosBox beginners, newbie and first timers guide

Updated in January 2014 to fix some formatting issues and broken links.
Updated in September 2010 for DOSBox 0.74.

DOSBox is a brilliant yet compact and easy to use virtualisation program designed to run old DOS applications under modern operating systems. This tutorial assumes you have a little understanding of the underlying DOS commands and the use of a command line.

This tutorial will be designed for Windows users, though DOSBox does work on other operating systems such as Mac OS/X, Linux and FreeBSD.

Download DOSBox from their website (

DosBox Installer

Run and install the newly downloaded DOSBox program. Follow all the defaults if you don’t understand any of the questions or prompts.

DOSBox 0.74 Windows start menu

Once installed, you should have a new DOSBox entry in your Windows Start Menu.

DOSBox 0.74 Manual is the extensive DOSBox instruction manual in plain text format.
DOSBox 0.74 is a shortcut to start the application. By default, it loads up a partner debugging console which is useful for troubleshooting your emulated DOS games and applications.
DOSBox 0.74 (noconsole) runs the application without the partner debugging console.
Screenshots & Recordings loads up Windows File Explorer to browse your DOSBox screen, audio and video captures.
Uninstall will remove DOSBox from your computer.
Video folder contains instructions on how to use the video capture feature within DOSBox. There is also link to the ZMBV codec that might be required to view your view your video captures within Windows Media Player.
DOSBox 0.74 Options loads up the default settings file used by DOSBox. It is a text INI settings file which is human readable and editable.
Reset KeyMapper will return DOSBox’s control and function keys back to their default.
Reset Options will return DOSBox’s settings file to its default.

To edit DOSBox’s settings, you need to click on the DOSBox Options shortcut. It should open up a configuration INI file within Windows Notepad. If you are using Windows Vista, you may need to right-click the shortcut and Run as administrator otherwise you might not be able to save any changes you make.

Within the file, you will see rows of text and settings most of which contain short descriptions. All the rows that start with a hash # are commented out which means DOSBox ignores them. Scroll down to the very bottom of the file, and you should encounter [autoexec]. It is where you will type and save commands that DOSBox will automatically instigate every time it starts up.

Somewhere on your computer, you will need to create a directory that DOSBox will use for its virtual hard drive. You will be able to copy files and folders into this directory and DOSBox will be able to access it. If you don’t know what this all means, then we will do a simple exercise to show you.

Go to Computer in your Windows Start Menu
Double-click your Local Disk (C:)
Right-click on the whitespace within the window but make sure no folders or files are selected
Select New and then Folder
Rename the newly created folder to DOS Hard Disk
Return to Notepad that is open with dosbox-0.74.conf.
Under [autoexec] on a new line add the following text …

mount C "C:\DOS Hard Disk\"

The first line tells DOSBox to mount your directory C:\DOS Hard Disk\ as a virtual hard disk and assign it a drive letter of C:
The C: tells DOSBox  to go to your newly created C: drive automatically.

Save your file in Notepad (File > Save).

Now run DOSBox.

DOSBox 0.74 startup

Thanks to our changes to the dosbox-0.74.conf file, DOSBox has automatically mounted the directory and used it as a pseudo hard drive. Now you are running a simulated DOS prompt.

In DOS to list the content of your hard drive, you use the command DIR which is probably short for directory list.

Currently, this shows the C: drive is empty.

Open Computer from your Windows start menu and go to your DOS Hard Disk folder located on your C: drive. Create a new directory and name it anything you want.

Now if you return to DOSBox and type DIR, your C: drive will still list your DOS hard disk as empty. DOSBox caches the drive on startup. So every time you make a file or directory change outside of DOSBox you need to refresh the cache using the RESCAN command or by using the [CTRL] F4 key combination.

Now download the file (

Download the file vgaseasn.exe ( It’s an old DOS VGA Christmas card demo created by Sierra Online back in the early 1990’s. Once downloaded, copy the file into your C:\DOS Hard Disk\ directory.

Using the DOSBox prompt RESCAN and then DIR. You should see the copied vgaseasn.exe directory.
Create a new directory named vgaseasn by running MKDIR vgaseasn
Move the file vgaseasn.exe to the directory vgaseasn by running MOVE vgaseasn.exe vgaseasn
To enter the directory use CD vgaseasn, once in use DIR to list the files within.
Run the program vgaseasn, and you should be prompted with the question Continue with Self Extraction?, answer Y

run vgaseasn

downloaded from sierra bbs

Use the DIR *.bat will list only the files with the BAT file extension. In DOS most games either used a file with a BAT (batch file), COM (command file) or more commonly an EXE (execute program) extension to start the program. Using DIR *.exe, you will see two files listed install.exe and sierra.exe.

Run the install.exe by typing install. It should run and a Sierra On-Line Game Install/Setup Program dialog should appear. Press [ENTER] to skip the dialog and you’ll go to a menu titled Installation Choices. There you will have a list of hardware selections, using your keyboard arrow keys move up to Graphics : VGA and press [ENTER].

You can see here that the Sierra On-Line installation program under DOSBox has detected both VGA and EGA graphic cards. Make sure VGA 256 colors is selected and then press [ENTER]. Return to the previous menu and scroll down to and select Music: .

Here you can see the Sierra install program detects some music cards that is emulated by DOSBox. [ESC] to return to the previous menu and then select Speech : . Again you will see many audio options available under DOSBox.

Now quit the install program by pressing [ESC] until you receive a red prompt asking you to exit. Back at the DOSBox prompt, type sierra. If everything goes well, an animated Christmas card will greet you. You can quit the program anytime by pressing [ESC]. Go back to the install program and play around with the graphic, music and sound options to see the effects.

Enjoy, I will have more tutorials in the future covering the functions and operations of DOSBox.

82 thoughts on “DosBox beginners, newbie and first timers guide

  1. is it possible to install an open source operating system(guest) in a windows 7(host) via dosbox? if yes, how? can u make a tutorial? please. this is project.

    1. Dosbox is an operating system emulator, not a hardware emulator like vmware or virtuabox. So you could probably only install an operating system that is designed to sit on top of DOS. Windows 1 to Windows 3.* and alternative DOS editions come to mind. FreeDOS is open and can be made to run within Dosbox.

        1. Dosbox is an emulation of DOS for installing on your existing operating system as a program. FreeDOS is an operating system that is designed as an open source replacement for Microsoft’s commercial DOS from pre-1995. It is not designed to run DOS games within Windows, Linux etc. To run a game in either dosbox or freedos would be the same process though.

  2. Hi! I have a windows 98 game on disc. Now I want to play this game in my Windows 7.64 operating system. When I try to start the setup.exe file in DOS BOX, I recieve a error message from DOS BOX saying “” This program must be run under Win32″”. Please Help. Thank you.

    1. DOSBox is a DOS emulation program. Windows 98 as an operating system is a few generations after DOS so a DOS emulation such as DOSBox is not going to be able to run a Windows 98 program. If you want to run a Windows 98 program within Windows 764bit you will need to right-click on on your game’s setup.exe, select Properties, select the Compatibility tab, click the Run this program in compatibility mode for: checkbox, and then select Windows 98 from the pull-down list.

  3. Hey I have a quick question, I already have a game loaded to C:\ how do I clear it so I can load a different game?

    1. C:\ is a virtual hard disk. You can have more than just a game there, but generally you should put each game into an individual directory. Try these commands in the DOSBox prompt for example.

      md doom
      cd doom
      cd ..
      ren doom doom2
      rd doom2

      You can find all the DOSBox commands by typing HELP /ALL

      To answer your question you might want to try DEL *.* <– IN THE DOSBOX prompt!
      Otherwise you could just use Windows explorer to delete the content of wherever C: is pointing to on your computer. Then in DOSBox you could refresh the directory cache by typing RESCAN.

  4. I have Duke Nukem 3D atomic edition – run it using dosbox and instaled; however it keeps asking me to place the cd on the drive to play – its already there.

    help please

    1. You need to mount the CD drive so that the Duke Nukem 3D game can actually discover the disc.

      If your drive is D then

      mount D D:\ -T cdrom

  5. The code above if entered into Dosbox.conf, when you open Dosbox, it will mount, load, and go to this folder and display the files with-in.

    Now just create batch files with the commands normally used to load doxbox games, place them in the gamelist folder (C:/gamelist)

    My Batch File Example- Type in notepad, save as FILENAME.bat

    mount c c:\harvest
    mount d d:\ -t cdrom


    I saved this batch file as harvest.bat. Now when I open Dosbox, it automatically opens the gamelist folder, and displays the files, (only harvest.bat now).

    Now you only have to type harvest.bat (or any other game.bat you have), to mount and play your games.

  6. Here is a neat trick I figured out for running Dosbox games fast ans easy.
    First edit the dosbox.conf file to mount a new drive letter and folder you will not use.

  7. hi just run thru this, it was going well untill it said “this program must be run under win32” can u help me please thankyou

    1. you need to provide a little more information then just a generic error message. such as what operating system you are trying to run dosbox under.

Leave a Reply

Please log in using one of these methods to post your comment: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s