DOSBox Raspberry Pi "recipe"


Moderators: Admiral of the Fleet, Vice Admiral

Post Reply
User avatar
Posts: 1593
Joined: Tue Oct 23, 2018 8:29 pm
Location: Hertfordshire

DOSBox Raspberry Pi "recipe"

Post by 0verzeal0us » Sat Mar 14, 2020 3:46 pm

  • A Raspberry Pi
  • Raspberry Pi Case (this is optional but it'll be tidy with a case and the official case is £6)
  • A Micro USB power supply (you can draw power from another device using a USB to microUSB cable).
  • An 8GB microSD Card (it'll work with cards from 4GB to 32GB)
  • An ethernet cable (and of course a spare port on your router or switch)
  • A keyboard and mouse (for the setup - I use one of these)
This guide was written using a Raspberry Pi Zero W v1.1 running Raspbian Stretch with Desktop and recommended software 13th November 2018 build. The version of DOSBox was 0.74 at the time of writing.

I do not know whether any 3rd party software is safe. By following the guide below you accept ALL responsibility. I will not be held accountable for any issues that may arise.

One. Download the latest version of Raspian from the Raspberry Pi Foundation.
Download Raspbian Stretch with Desktop from

Two. "Burn" the image to the SD card using Etcher.
Download from

Three. Run through the "out of the box" wizard.
Connect power (microUSB), network and a monitor to the Pi and allow it to boot up then follow the "Welcome to Raspberry Pi" wizard.
  1. Set the locale and keyboard language as required
  2. Aet the password for user 'pi'
  3. Connect to wireless network
  4. Updating Raspbian

Four. Enable remote GUI access (and do some optional customisations to the desktop)
Go to "Start", Preferences, Raspberry Pi Configuration.
  1. System: Disable Splash Screen.
  2. Interfaces: Enable VNC.

Five. Update the Pi Firmware and Install the relevant packages
Open the Terminal and type (wait for each command to finish before proceeding).

Code: Select all

sudo rpi-update
sudo apt-get update
sudo apt-get dist-upgrade

Install DOSBox
Open the Terminal and type (wait for each command to finish before proceeding).

Code: Select all

sudo apt-get install dosbox
Type y and press enter

Code: Select all

mkdir ~/dos-games
nano ~/.dosbox/dosbox-0.74.conf
Find the lines

Code: Select all

Change to

Code: Select all

Save the file by pressing ctrl-x, pressing y then enter.
For full information on the configuration file, please see the official wiki:

Install a game!
Personally, I use MyAbandonware to get my DOS games. If the game is licensed, you can purchase it through the relevant vendor.
I've downloaded Discworld (an old favourite of mine). Grab a copy from here. If you're using a Pi Zero as demonstrated in this guide, I'd download the file on your PC and use VNC Viewer to copy the file to the Pi.
Rename the file (to something simple) and then move it into the Downloads folder.
Open the Terminal and type (wait for each command to finish before proceeding).

Code: Select all

unzip ~/Downloads/ -d ~/dos-games/

Play the game!
Open the Terminal and type

Code: Select all

mount c ~/dos-games/discwrld


Post Reply