Raspberry Pi

How to install Doom on Raspberry Pi

Who doesn’t want to have fun while playing a game? You would be hard pressed to find someone who is not interested in playing games on their Raspberry Pi. People enjoy playing video games, particularly action games.

If you are finding a good first person action game, give Doom a try. Doom is a classic shooter game that you should definitely have on your Raspberry Pi. Carefully read each step from this article to install Doom on your Raspberry Pi.

You won’t need any emulators (such as Recalbox or RetroPie) to run this retro classic on your Raspberry Pi. Doom can be run on the Raspberry Pi by installing the WAD files and game engines. WAD files are required for a game as they contain necessary packages, graphics and data files that help you in the installation of a game.

Before proceeding with the installation of Doom on the Raspberry Pi, it is necessary to understand the hardware requirements for Doom’s installation. If your machine meets the requirements listed below, you can easily install it and enjoy the gaming experience.

List of required things for Doom

  • USB mouse
  • USB keyboard
  • Raspberry Pi model B
  • Ethernet cable or Wifi
  • SanDisk SDHC 16GB memory
  • Doom Source code

How to install Doom on Raspberry Pi

Doom source codes are available in a variety of versions online. In this case, we will use the Chocolate Doom version, which is more suitable for the majority of WADs. Chocolate Doom is a Doom Source port, which provides you the same gaming experience of 1990’s game named as Doom. Thus, it’s the most ideal choice for you to run this version.

To begin, enter the following command into the terminal of your Raspberry Pi to install Chocolate Doom

$ sudo apt install chocolate-doom

Wait for it to install, it can take some time.

Install Doom WAD Files on your Raspberry Pi

After the successful installation of the Doom engine on your Raspberry Pi, you are now required to install the Doom’s WAD file on your Raspberry Pi.

You can easily find different versions of WAD files online, just like you can find different versions of DOOM. You can find some other alternative solutions as well. However, we will provide you with an easy-to-follow example here. The only thing you need to do is install a WAD using a Doom standalone data file. When you successfully install it , the maps and weapons used in the Doom will be automatically installed to the game.

Go to the terminal of Raspberry Pi and add the below command. The wget command below will download the Doom WAD file for you.

$ sudo wget https://www.doomworld.com/3ddownloads/ports/shareware_doom_iwad.zip

The Doom WAD file is a zip file, so you must unzip it in the terminal using the unzip command.

$ sudo unzip shareware_doom_iwad.zip

After unzipping the zip file, the WAD file will be downloaded and your Doom game will be prepared for you. Now after this step, you are able to run the Doom game.

Configuring Doom for Raspberry Pi

Now is the time to connect your Raspberry Pi to a keyboard. You may also connect using VNC or RDP, however this will cause your game to be slightly jerky. Before you start playing, it is compulsory for you to stop using a remote connection!

In order to play the game, you will need to configure it first through following the command in the terminal of the Raspberry Pi.

To begin playing the game, you must first set it up by running the command on the Raspberry Pi’s terminal.

$ chocolate-doom-setup

The following screen will configure the display, mouse, keyboard and other game controller for you.

After completing the setting, save the parameters and launch the Doom game.

Launch Doom using Command in Raspberry Pi

If you don’t want to use the setup tool to customize your game every time, there is another alternative to save time. If you add the below command, you may avoid the configuration tool. The command below will launch the game in full screen mode and you don’t have to worry about setting the display of the game.

$ chocolate-doom -iwad DOOM1.WAD

The chocolate doom can also be launched from the games option present in the menu.

Playing Doom on Raspberry Pi is a worth experience

Playing games on Raspberry Pi depends on your preference. No one is bound to play on a big screen. But if you do have a big screen, you can enjoy it more. You could choose a large-screen TV with an Xbox gaming controller. Maybe you have already turned your Pi into a portable gaming computer with a built-in controller.


It is a worthwhile experience to play games on the Raspberry Pi. Follow the steps above to install Doom. Unlike other games, Doom is easy to install and will be on your Raspberry Pi in no time. Doom is available on the internet in a variety of versions. You can also try them if you have a good performance machine. Their installation procedures are very similar to other versions. So, don’t be afraid to go for it if you truly want to experience a high-quality graphic game. I believe you will appreciate having them on your Raspberry Pi.

About the author

Awais Khan

I'm an Engineer and an academic researcher by profession. My interest for Raspberry Pi, embedded systems and blogging has brought me here to share my knowledge with others.