Building Chocolate Doom on Debian

From Chocolate Doom
Jump to: navigation, search
Chocolate Doom running under Ubuntu Linux, a distribution derived from Debian.

chocpkg is the official way of building Chocolate Doom on all platforms from v3 onwards. What follows are instructions for building Chocolate Doom the Debian GNU/Linux way. These instructions also apply to building under distributions derived from Debian, including Ubuntu.


The first step is to install the necessary dependencies for building Chocolate Doom. The easiest way to do this is to use the Debian package manager. Run this command as root:

apt-get install gcc make libsdl2-dev libsdl2-net-dev \
    libsdl2-mixer-dev python-imaging

On Debian 10 python-imaging was replaced with python-pil package.

Several packages will be installed.


GEBB cover.png For a good introductory guide to the Doom source code, check out the Doom Game Engine Black Book!

Download the source package from the Downloads page. Extract the package: for example,

tar xzf chocolate-doom-3.0.0.tar.gz

Then build the package:

cd chocolate-doom-3.0.0
make install

The final "make install" command should be run as root.

Tracking Git[edit]

To keep up to date with the latest bleeding-edge version of Chocolate Doom, you can build the latest version from the Git repository.

To do this, you need to install some extra packages:

apt-get install automake autoconf libtool git pkg-config

Check out the latest version from Git:

git clone

Then build the package:

cd chocolate-doom
make install

To keep up to date, periodically run these commands to update your checkout and rebuild:

git pull
make install