DOSBox · Windows

DosBox Beginners, Newbie and First Timers Guide

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

DOSBox is a brilliant yet compact and easy to use virtualization program designed to run old DOS applications under modern operating systems. This tutorial assumes you have a little understanding of the basic 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 troubleshoot 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 back to its default.

To edit DOSBox’s settings you need to click on the DOSBox Options shortcut. This 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]. This 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 it’s 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.

Goto 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 back to Notepad that is opened with dosbox-0.74.conf.
Under [autoexec] on a new line add the following snippet.

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 automatically go to your newly created C: drive.

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 goto 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.


You should see the copied vgaseasn.exe directory. Create a new directory named vgaseasn.

MKDIR vgaseasn

Move the file vgaseasn.exe to the directory vgaseasn

MOVE vgaseasn.exe vgaseasn

Enter the directory and list the files within.

CD vgaseasn

Run the program.


You should be prompted with the question Continue with Self Extraction?, answer Y.

run vgaseasn

downloaded from sierra bbs

This command will list only the files with the BAT file extension.

DIR *.bat

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.

DIR *.exe

Will list two files listed install.exe and sierra.exe.

Run the install.exe.


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 oth 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 a number of music cards that is emulated by DOSBox. ESC to return to the previous menu and then select Speech. Again you will see a number of 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.


If everything goes well you will be greeted with an animated Christmas card. 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. 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.

  2. 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.

  3. 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.

  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. 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.

  6. 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.

  7. 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.

  8. I’m trying to get Return to Zork to play through Dosbox. It plays, and does rather well. Only thing is, when I start the game up it says “cannot open z:\fintro00.pmv. That, and it won’t open any of the other files that have to do with the wizard talking to you while you’re going through places. I have the files in every folder I can think of that it would need to go through but it still doesn’t work. Can you help me?

    1. Return to Zork was released on CD-ROM and floppy disk back in 1993. Are you running the game off the original media because by the sounds of your error it seems you are running a downloaded, CD-ROM pirated ‘ripped’ version? That error means you are missing the game’s introduction that was originally sitting on the CD-ROM. To correct this you can legally buy the game for $5.99 from GOG which comes with the whole game intact and has been tested to work under Windows.

      Or if you do own the original media, please accept my apology and can I suggest trying it under ScumVM

      1. Oh, no, I’ve got the game and a ripped version of it. I’ve been using both the entire time. But it still doesn’t seem to want to work with me.

      2. No need for apologies, dude. I’m just glad someone has even somewhat of an idea of how to fix it. I’m just trying to get the game to work again so i can play it. It’s also sort of a surprise for my mom since it’s her game and she hasn’t been able to play it in over a decade. I just recently found out about the Dosbox.

      3. Sadly, no. The program didn’t seem to want to work. Although, I’m no genius. I really don’t have a clue of how to work it, but I did get it to where it would try to start it up. Only, it would just have a black screen.

  9. I have a question regarding saved games. I used Oldgames to download TSR’s Goldbox series of games. Characters can be imported from one game in the series into the next. The problem I’m having is that I cannot get the characters to transfer. I managed to get my characters moved to the second game in the series by exiting the game in DOSBox to get to the command line and using “ren” command to move the files from the “c:\POOLS” folder to the “c:\CURSE” in a last ditch attempt to make it work. This worked because both the first Pools of Radiance) and second game (Curse of the Azure Bonds) saved characters with a filename based on their actual name and the extension “.cha”. The third game does not use that extension, but can transfer the game. It believe the game I’m trying to play looks for the previous characters under the “c:\curse\save” folder. Here’s the specs:

    Native OS: Windows XP
    Dosbox v 0.72 running DOS
    Games Secret of the Silver Blades TSR 1989(ish?)

    Actual organization of games
    c:\program files (x86)\Oldgames\Pool of Radiance\c\

    I have moved all three games under this folder so that DOSBox mounts the above address as c:/

    Once DOSBox is run and I go to the command line I can find all the files I need to look at, but I cannot find them when exploring in windows. Where do they go???

    1. Surprisingly for the extensive information you have given Mike I am still a little confused by your question. Any file on your hard disk in DOSBox will be shown in Windows file explorer. So if your mount folder for DOSBox is located in c:\program files (x86)\Oldgames\Pool of Radiance\c\, that is where they will be under Windows. DOSBox command line does not move files anywhere outside of the mount folder.

      I think the problem you maybe having is that by default Windows XP/Vista/7+ hides file extensions that it recognises so a file name README.TXT will only be shown as README. So I am guessing you may need to disable this hide extension feature?

      In Windows (file) Explorer use the pull-down menu at the top to select ‘Tools’, ‘Folder Options’ .. select the ‘View’ tab and look in the ‘Advanced settings’ for ‘Hide extensions for known file types’ and uncheck it. I am using Vista/7 so the menu navigation to get to that checkbox might be slightly different in XP. Let me know if that helps.

  10. Great program, easy to use, BUT, wonder if someone can help me, played around 15-20 games perfectly (especially love being able to adjust the game speed) – after 20 or so games, and I’m not sure if I’ve messed up some setting somewhere, the games don’t full screen when I ALT+ENTER, the screen goes full screen, but I have a 640 x 480 game with a huge black border..

    tl:dr: The window can be full screened, but the game stays the same size

    1. In your settings file look for the following under [sdl].


      That setting locks the game to it’s original resolution in full screen mode, so delete that line and the border should be removed.

    1. Do you mean whether you can target a Turbo C++ program for DOS, then yes you can with the earlier versions. There are a few versions of the Turbo C++ IDE that run in Windows but compile for DOS.

  11. Hey, I just installed Dosbox, and learned to use it. I started playing The old dos game “syndicate” Yesterday, and it works great. The only problem is that i can’t save the game. Can you please help me solve that problem?

    1. This is not really a technical support for DOS games but generally games on the 1990s relied on buyers reading manuals. You can find a copy of the 59 page Syndicate manual here It might be worth talking a look at incase you are missing some other core elements of the game.

      According to that manual to save your game you press Esc in-game to bring up the main menu and then select the Save and Load Game option.

    1. You put the files in your DOSBox Virtual drive, not your Windows C: drive. In this example the DOSBox Virtual drive is “C:\DOS Hard Disk\”

  12. I have been trying to load the kings quest vii for my mother. I went through the installation while in dosbox as recommended and when i cd sierra.exe it gives me an error saying ‘unable to change to: sierra.exe’ but it doesn’t give me a reason why. I’ve tried everything from uninstalling and reinstalling to trying different drives and it still isn’t working. i’m at my wits end with this program file. also on my own computer it says ‘internal error occured. error 99’ or something. *sigh* i’ve tried to looking to other sites for help but you’re the only one that i see that seems to know what they’re talking about. please any help would be appreciated we are anticipating playing this game again.

    1. Hi Xylina, you seem to be using the wrong commands. CD is used to change into directory. SIERRA.EXE is the Kings Quest program file. Trying to CD into a file like you were attempting with CD SIERRA.EXE will always give an error. Instead just try SIERRA.EXE by itself. If you are finding that using DOS commands are too much effort you can legally buy and download Windows edition Kings Quest 7 & 8 packaged together from Good Old Games for $10. They optimise the install process and running of the games to work on modern day computers.

    1. Sorry Nidhi but your question is a little vague so I don’t know if I can help. Please read and follow the article at the top of this page. You run a program by typing its name and pressing enter. If your c++ project is not compiled as a DOS EXE program file then I suggest using Google to find out how to do that.

  13. Hi Ben. I wonder if you could give me advice on how to save my game in DOSbox. I know someone asked about it too but my problem isn´t exactly the same.. (I think). -I have an old 4 cd´s game only in ISO files (wing commander 3 to be exact). I imagemounted the cd´s and the playing is fun but as I tried to save it (there is a menu in the game where this can be done, and the game happily tells me that the game is saved..) and closed the DOSbox I wasn´t able to load the game anymore the following day. -Instead I had to imagemount the 4cd iso.files all over again and when the game started the list of saved games was empty. — now.. I am clueless what to do with this since I´ve only used DOSbox in these last 2 days. I have Vista os, DOSbox 0.74 and a crappy 5 years old HP laptop. What can I do next? 🙂

    1. Okay the quick and easy option would be to spend $6 and rebuy the game on They will legally sell a copy of the game to you but also package it and test it to work on Windows XP, 7, 8

      Otherwise what you may have to do is insert the first CD and get it to install some game files. Generally if you do a DIR command on the ISO mount there should be a file INSTALL.COM, INSTALL.BAT, INSTALL.EXE or something similar. ISO images are CD-ROM images, the ROM stands for Read Only Memory meaning you cannot write data to it. So CD games from this period generally installed part of the game to a computer’s hard drive (DOSBox C:) and used that for save games and temporary files.

    1. DOSBox is a program that emulates an old PC running the Microsoft DOS operating system. Generally software designed for Microsoft Windows will not work under DOS or DOSBox. If you want Turbo C working on DOSBox you need an early edition that supports DOS rather than Windows, as they are different pieces of software.

      If you just want to get Turbo C to work on your 64-bit Windows 7 system you may want to use virtualisation software so you can install and run an older 32-bit version of Windows within Windows 7.

      See Vmware Player
      Or VirtualBox

    1. Hi Michael did you follow the previous steps in the article ?

      + 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

        1. Did you type mount C "C:\DOS Hard Disk\" into Notepad rather than copy/paste from the blog?

          I ask as the " (double quotation mark) is a different character to “ ” (curly quotation marks).

          Unfortunately WordPress automatically converts " into ” . I noticed the blog unintentionally displayed curly quotes and I have since fixed this.

  14. I dowwnloaded dosbox for running turbopascal on windows 7. It seems to work, but I am unable to show the program in full screen. I only have a window, and can’t make it fulle size. Can you help me?

    1. Hi Toben, in DOSBox type “intro special” without the quotes. That will list a number of useful key combinations including how to go full screen and back.

  15. One problem I’m having is making Paradox properly work in DOS BOX 0.74. When I open Paradox in it, it says the home directory of the version I’m using does not exist and when I go to change directories, the directory I want that is on my computer does not show up in Paradox (whereas it DOES show up in Paradox when I open Paradox directly into Windows 7 HP 32-bit on the small screen). I’m trying to figure out how to do this ahead of possibly having to replace two XP machines with machines that have Windows 8.1 64-bit with XP no longer being supposed.

    Any help on fixing this issue. I also downloaded version 0.60 which Paradox is supposed to work on, but could not get it to work there either.

    1. Hi Wallyhorse, I had to Google ‘paradox dos’ to work out what you were referring to. I assume you are talking about the database?

      DosBox has a small tidbit of information on Paradox.

      Otherwise you can run DOS on any modern computer using VMWare Player or Oracle VM VirtualBox. There is a bit of a learning curve for first time users of virtualization but that would be your best bet to start.

      You will also need a copy of DOS to use with either software. FreeDOS would be your best bet if you don’t have access to MS-DOS or PC-DOS.

  16. 1) I installed dosbox to play a game.
    2) My laptop now takes 97% of it’s usage to run.
    3) Uninstall.exe file not found.
    4) So I did a backup.
    5) Dosbox still there without uninstall option.

    What should I do now?

    1. Hi Amanda, unfortunately I am a blogger not a technical support. But I would make sure you actually downloaded and installed DosBox from the official website on

      DOSBox does not run at start-up. So if you rebooted and your computer is still running slowly I believe something else would be causing it.

      You can press [Ctrl] [Alt] [Del] keys together on your Windows keyboard and bring up the Task Manager. That will tell you what is using all your processes, and from there you can kill whatever is slowing your system down.

  17. Hello, I am new on DosBox, I have Windows 10 and am trying to run simple asm file but it says “This program cannot be run in DodMode”…First DosBox was not opening but then I attached external device I-e mouse, now it is opening and I have mounted and everything but it gives this error when I run an asm file.
    Please Help urgent..

  18. Like another individual in the comment section, I too am having issues downloading King’s Quest 7. Every time I enter “install”(.bat) it says “Can’t find KQ7INST.001”. The file it says it can’t find IS in the folder. This is the second KQ7 file I’ve downloaded, each are from different sites (just in case one of the files were incomplete or bad). I’m just frustrated at this point. Any helpful tips in regards to this?

    1. Hi tcoftw,

      DOS is rather archaic and there was no standard way to install software onto it. So developers made their own install utilities and tools. Sometimes they included multiple tools for different tasks. So that install.bat could be to copy the game from the original CD-ROM onto a person’s hard drive and maybe useless for you. Have you tried running the game in DOSBOX instead of trying to install it before hand?

      Otherwise you can buy the game from here. It will guarantee to work on modern computers.

  19. i have windows 7 and im trying to play kings quest VII when i type in all the information in dos box it comes up and says this program requires microsft windows. i dont know what i am doing wrong please help

    1. Hi Judy, I believe you are running the Windows 95 release of this game. There were multiple versions created for different platforms and systems of the era. Unfortunately DOSBox only works with DOS games, not Windows.

  20. Hi I have been using the free DOSBox for Android, and it’s great. But it doesn’t seem to come with a text editor. Could you recommend (a preferably free) one, just so I don’t have to rely on the PC to edit config / autoexec files. Thanks

    1. I am not sure if you mean for android or a text editor for dos? FreeDOS (an open sourced DOS clone) has ‘edit’ which would work in dos box.

  21. Hey mate, ive been trying to run Warcraft: orcs and humans, and i get to the install and try and select destination directory it tells me it cant create the directory, can you help at all?

    1. Hi Jordy,
      If you’re installing from a CD you need to first make sure the destination directory is on the C:\ hard drive.
      Otherwise maybe try creating the directory manually before running the install program.

      mkdir c:\warcraft

  22. Hello, I have been trying to use dos box to play my dune 2000 cd from 1998 (made for windows 95) on my computer. The win32 Error message comes up and I can’t play my game. Is there a way to fix this? Dune 2000 is a win16 game.

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 )

Google+ photo

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

Connecting to %s