Compiling the Zandronum server on a Raspberry Pi

From Zandronum Wiki
Jump to: navigation, search



The following article is for Zandronum 2.1.2. It probably won't work on the latest release (3.0).

It is possible to compile zandronum-server on a Raspberry Pi. It is mostly the same as compiling on Linux, but we have to disable some things first.

You can not combine the Zandronum client on a Raspberry Pi, as:

  1. The software renderer requires assembly files, and assembly files are only available for the ia32 and x86_64 CPU architectures, and not the Raspberry Pi's ARM architecture.
  2. The OpenGL renderer uses normal OpenGL, which is not supported by the Raspberry Pi. The Raspberry Pi only supports OpenGL ES.

Getting Started

You will need:

  • A Raspberry Pi.
  • Access to a terminal on your Raspberry Pi.

This guide was written for the Raspberry Pi Model 2B, but should work on all models.

Install Dependencies


  $ sudo apt-get install build-essential zlib1g-dev libsdl1.2-dev libjpeg-dev \
    nasm tar libbz2-dev libgtk2.0-dev cmake mercurial libfluidsynth-dev libgl1-mesa-dev \

Arch Linux ARM

  $ sudo pacman -S --needed gcc make zlib sdl libjpeg-turbo nasm tar bzip2 gtk2 cmake mercurial \
    fluidsynth mesa glu openssl

Prepare Environment

Create and cd to your working directory:

   $ mkdir $HOME/zandronum-build && cd $HOME/zandronum-build

Clone the Zandronum repository:

   $ hg clone .

Get the latest stable release (for other versions replace "max(tagged())" with one of the tags found in the repository):

   $ hg update -cr "max(tagged())"

Apply patch that fixes compilation under Raspberry Pi:

   $ wget -O raspi.patch "" && \
     hg import --no-commit raspi.patch && \
     rm raspi.patch

Create and cd to the directory where build files will be outputted:

   $ mkdir buildserver && cd buildserver

Generate Makefiles

Run cmake, this generates the Makefiles.

   $ make clean; \

The -DNO_ASM=1 argument is important as it doesn't compile the architecture-dependent assembly code.

Compile Zandronum

Now, run this command to build Zandronum.

   $ make -j$(nproc)

This compile Zandronum using all of your Raspberry Pi's CPUs.

Run Zandronum

Assuming all went well, you should now have a zandronum-server binary in your working directory. To launch it:


You'll probably want to add the -iwad parameter to get it to successfully launch, though.

Once you've set it all up, enjoy playing on your Pi-powered server!

Pi server.png