Sign inSign up

frozenfoxx/zandronum-server

By frozenfoxx

•Updated 8 months ago

Container for running a Zandronum server

Buildkit cache
Image
Web servers
1

2.9K

frozenfoxx/zandronum-server repository overview

⁠zandronum-server

A Docker⁠ container for running a Zandronum⁠ server.

Source: https://github.com/frozenfoxx/docker-zandronum-server/⁠

⁠How to Build

To build the default image input the following:

git clone https://github.com/frozenfoxx/docker-zandronum-server.git
cd docker-zandronum-server
docker build -t frozenfoxx/zandronum-server:latest .

If you wish to build WAD files into the container or simply wish to have defaults, include them in the wads directory prior to building.

⁠How to Use this Image

⁠Quickstart

The following will run the latest Zandronum server with a default configuration.

docker run -it \
  --rm \
  -p 10666:10666 \
  -v /Path/To/WADs/:/wads:ro \
  --name=zandronum-server \
  frozenfoxx/zandronum-server:latest \
  -iwad /wads/DOOM2.WAD

⁠Adding Options

All arguments passed to the container are forwarded directly to zandronum-server -host. You can pass any combination of Zandronum command-line parameters and console variables:

docker run -it \
  --rm \
  -p 10666:10666 \
  -v /Path/To/WADs/:/wads:ro \
  -v /Path/To/Configs/:/configs:ro \
  --name=zandronum-server \
  frozenfoxx/zandronum-server:latest \
  +sv_hostname "My Zandronum Server" \
  -port 10666 \
  -iwad /wads/DOOM2.WAD \
  -file /wads/brutal_doom.pk3 \
  +exec /configs/global.cfg \
  +exec /configs/coop.cfg

A full list of options and how to enable them is provided on the ZDoom Wiki⁠.

⁠Docker Compose

Below is an example docker-compose.yml for running a server:

services:
  zandronum:
    image: frozenfoxx/zandronum-server:latest
    container_name: zandronum
    network_mode: host
    restart: unless-stopped
    command: >
      +sv_hostname "My Zandronum Server"
      -port 10666
      -iwad /wads/DOOM2.WAD
      -file /wads/maps/mymod.pk3
      +exec /configs/global.cfg
      +exec /configs/coop.cfg
    volumes:
      - /path/to/wads:/wads:ro
      - /path/to/configs:/configs:ro

Complex or per-server arguments can be managed with environment variables and an override .env file:

services:
  zandronum:
    image: frozenfoxx/zandronum-server:latest
    container_name: zandronum
    network_mode: host
    restart: unless-stopped
    command: >
      +sv_hostname "${ZANDRONUM_HOSTNAME:-My Zandronum Server}"
      -port ${ZANDRONUM_PORT:-10666}
      ${ZANDRONUM_COMMAND}
    volumes:
      - /path/to/wads:/wads:ro
      - /path/to/configs:/configs:ro

With a corresponding .env file:

ZANDRONUM_COMMAND=-iwad /wads/DOOM2.WAD
  -file /wads/maps/Lexicon/lexicon.pk3
  +exec /configs/global.cfg
  +exec /configs/coop.cfg
  +map VR
ZANDRONUM_PORT=10666

⁠Multiplay

A Multiplay⁠ compatible version of this container is also available. For deployment to Multiplay, you will need to follow their Container guidelines⁠.

  • Copy your WAD files into wads.
  • Build the container (docker build -t localhost/zandronum-server:multiplay -f Dockerfile.multiplay .).
  • Authenticate, tag, and push to Multiplay in alignment with their documentation⁠.

Tag summary

Content type

Image

Digest

sha256:8c466ff21…

Size

223.8 MB

Last updated

8 months ago

docker pull frozenfoxx/zandronum-server