Compiling the Zandronum server on a Raspberry Pi

From Zandronum Wiki
Jump to navigation Jump to search

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 4B, but should work on all older models.

Install Dependencies

Raspberry PI OS (formerly known as: Raspbian)

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

Arch Linux ARM

  $ sudo pacman -S --needed gcc make zlib sdl libjpeg-turbo nasm tar bzip2 gtk2 cmake git \
    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:

   $ git clone

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

   $ cd ./zandronum-rpi
   $ 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. Note: you might need to replace the pk3 to the 3.0 before running this because accidentally messed up the pk3.

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

Pi server new.png