Run Doom on Raspberry Pi and Low-Power Mini PCs

Yes, you can run classic Doom on a Raspberry Pi and other low-power mini PCs. The original 1993 Doom engine is extremely lightweight, so even the smallest Raspberry Pi models and many cheap ARM-based mini PCs can run it smoothly at full speed. This article explains what you need, how to set it up, and what to expect from different hardware.

Why Classic Doom Runs on Almost Anything

The original Doom was designed in 1993 for PCs with a 33 MHz Intel 486 processor, 4 MB of RAM, and no graphics acceleration. The entire game engine (id Tech 1) is a software renderer that draws every frame in the CPU. Modern low-power ARM chips are thousands of times faster than that 486, so raw performance is rarely a bottleneck. The main challenges are getting the game files legally, choosing a compatible source port, and handling audio and input on Linux-based systems like Raspberry Pi OS.

What You Need to Run Doom

To run classic Doom on a Raspberry Pi or mini PC, you need three things:

• A source port – a modern re-implementation of the Doom engine that runs on Linux. Popular choices include Chocolate Doom (faithful to the original), PrBoom+ (more features), and GZDoom (modern 3D-accelerated port with many options).
• The original game data files – the .WAD files (e.g., DOOM.WAD for the shareware episode, DOOM2.WAD for Doom II). These are not open source; you must own the game. You can buy the official Doom and Doom II from digital stores like GOG or Steam, then copy the WAD files to your Pi.
• An operating system – Raspberry Pi OS (based on Debian Linux) is the most common, but any Linux distribution for ARM will work. You can also use RetroPie, which is a pre-configured emulation and gaming distribution that includes Doom source ports.

How to Install and Run Doom on Raspberry Pi

The easiest way is to use RetroPie, which includes several Doom source ports in its package manager. Here are the general steps:

1. Install Raspberry Pi OS (or RetroPie) on your Pi’s SD card.
2. Open a terminal and install a source port. On Raspberry Pi OS, you can run sudo apt install chocolate-doom or sudo apt install prboom-plus. For GZDoom, you may need to compile it or use a third-party repository.
3. Copy your legally owned DOOM.WAD or DOOM2.WAD files to a folder on the Pi, e.g., ~/games/doom.
4. Run the source port with the WAD file. For example: chocolate-doom -iwad ~/games/doom/doom2.wad
5. Configure controls. You can use a USB keyboard, a USB gamepad, or even a Bluetooth controller. Most source ports allow you to remap buttons in the options menu.

Choosing the Right Source Port for Your Hardware

The source port you choose matters more than the hardware. Here’s a quick comparison:

• Chocolate Doom – Aims for 100% accuracy to the original. Runs on any Pi, even the original Raspberry Pi 1. Minimal features, but the most authentic experience.
• PrBoom+ – Adds features like widescreen support, higher resolutions, and more compatibility with modern mods. Still runs on very old Pi models.
• GZDoom – Uses OpenGL for hardware acceleration, supports modern mods (like Brutal Doom), dynamic lighting, and 3D floors. Requires a Pi 2 or newer; on a Pi 4 or Pi 5 it runs well at 1080p.

For a Raspberry Pi Zero or Pi 1, stick with Chocolate Doom or PrBoom+. For a Pi 3 or newer, GZDoom is a great choice if you want mods and higher resolutions.

Performance on Different Raspberry Pi Models

All Raspberry Pi models can run the original Doom at full speed, but the experience varies with the source port and resolution:

• Raspberry Pi Zero / Zero 2 – Chocolate Doom runs at 320×200 or 640×400 perfectly. GZDoom is too heavy.
• Raspberry Pi 2 / 3 – PrBoom+ runs at 1080p with ease. GZDoom runs at 720p or 1080p with moderate mods.
• Raspberry Pi 4 / 5 – GZDoom runs at 1080p with high-quality settings and most mods. Even 4K is possible with some tweaks.

Other low-power mini PCs, like those with Intel Atom or Celeron processors, will also run Doom without issues. The only limiting factor is the GPU driver for GZDoom; if you have a Linux system with proper OpenGL support, you’re fine.

Common Issues and How to Fix Them

Here are the most frequent problems people encounter and their solutions:

• “IWAD not foundâ€� error – The source port can’t find the WAD file. Make sure you have the file and specify the correct path with -iwad.
• No sound or choppy audio – On Raspberry Pi OS, audio may default to HDMI. Use raspi-config to set audio output to the 3.5mm jack or a USB sound card. Also, try a different source port, as some have better audio mixing.
• Game runs too fast or too slow – This is usually a vsync or frame rate issue. Enable vsync in the source port options or set the display refresh rate to 60 Hz. Chocolate Doom has a -timedemo option to test performance.
• Controller not working – Most source ports use SDL for input. If your controller isn’t recognized, try a wired USB controller, or configure it in the source port’s input settings. On RetroPie, you can map buttons in the EmulationStation menu.
• GZDoom crashes on startup – Often a GPU driver issue. Update your system, install the latest graphics drivers, or try a different video mode (e.g., -vidmode 0).

Frequently Asked Questions

Can I run Doom on a Raspberry Pi without buying the game?

You can run the shareware version of Doom, which is freely distributable. The shareware episode (Knee-Deep in the Dead) is included in many Linux packages as doom-shareware. However, the full game requires the original WAD files, which you must purchase. There are also free alternatives like Freedoom, which replaces the copyrighted assets with open-source ones, but it’s not the original Doom.

What is the best source port for Raspberry Pi 4?

For a Pi 4, GZDoom is the best choice if you want modern features and mods. If you prefer a more classic experience, PrBoom+ is lighter and still supports many enhancements. Chocolate Doom is only recommended if you want the exact original look and feel.

Can I play Doom mods like Brutal Doom on a Raspberry Pi?

Yes, but only with GZDoom. Brutal Doom and other complex mods require GZDoom’s advanced features. On a Pi 4, you can run these mods at 720p or 1080p with some settings reduced. On a Pi 3, expect lower frame rates; it may be playable but not smooth.

Do I need a keyboard to play Doom on a Raspberry Pi?

No, you can use a USB or Bluetooth gamepad. Most source ports support gamepads natively, and you can map all the controls (move, shoot, strafe, use) to the buttons. A keyboard and mouse gives you the most precise control, but a gamepad is fine for casual play.

Is it legal to download Doom WAD files from the internet?

Only if you own the game. Downloading WAD files from unofficial sources is piracy and illegal. The legal way is to buy the game from a digital store and copy the WAD files to your Pi. The shareware WAD is freely distributable, but the full versions are copyrighted.

Will Doom run on a Raspberry Pi Zero 2 W?

Yes, the Zero 2 W is much faster than the original Pi Zero. It can run Chocolate Doom and PrBoom+ at full speed, even at 640×400 resolution. GZDoom will not run well, so stick to the lighter ports.

Conclusion

Running classic Doom on a Raspberry Pi or low-power mini PC is not only possible but actually a great way to experience the game on a tiny, energy-efficient device. The key is to choose the right source port for your hardware, use legally obtained game files, and configure audio and input properly. With a little setup, you can have a portable Doom machine that fits in your pocket.

Related

• Valor Mortis Alternatives for Parry-Focused Combat
• Pixel 10 Pro 60Hz vs 120Hz: Which Refresh Rate Setting Should You Use?
• Expandable Housing & Faster Project Delivery