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 (http://www.dosbox.com).

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 text …

mount C "C:\DOS Hard Disk\"
C:

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 vgaseasn.zip (http://www.bengarrett.info/blog/vgaseasn.zip).

Download the file vgaseasn.exe (http://thelarkins.com/fun/SierraChristmas/1992/). 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 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 sierra. 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.

About these ads

67 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

    • 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
    =============================================================

    @ECHO OFF
    mount c c:\harvest
    mount d d:\ -t cdrom
    c:\
    harvest.exe

    —————————————————————-

    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

    • 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?

    • 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
      dir
      cd doom
      cd ..
      ren doom doom2
      rd doom2
      dir

      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.

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

    • 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. http://www.freedos.org/.

        • 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?

    • 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 http://www.gog.com/en/gamecard/return_to_zork 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 http://www.scummvm.org/.

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

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

      • 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???

    • 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

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

      fullresolution=0×0

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

    • 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?

    • 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 http://www.replacementdocs.com/download.php?view.879. 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.

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

    • 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. http://www.gog.com/gamecard/kings_quest_7_8. They optimise the install process and running of the games to work on modern day computers.

    • 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? :)

    • Okay the quick and easy option would be to spend $6 and rebuy the game on GOG.com. 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 http://www.gog.com/gamecard/wing_commander_3_heart_of_the_tiger.

      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.

    • 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 http://www.vmware.com/products/player/
      Or VirtualBox https://www.virtualbox.org/

    • 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

        • 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?

  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.

Leave a Reply

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

WordPress.com Logo

You are commenting using your WordPress.com 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