afey/zomboid repository overview

⁠Project Zomboid server - Docker image

Docker version of the Project Zomboid steam server.

⁠Donations

If you feel the urge to support me, feel free to buy me a virtual coffee ;-)

https://www.buymeacoffee.com/evilseed⁠

⁠How to use this image

⁠Before starting

Create two directories where you want to run your server :

• server-data: mandatory if you want to keep configuration between each restart
• server-files: optional, contains all the files of the application

If you have any errors with the permissions of these two directories, you can adjust it. It could be done with this commands:

chown 1000:1000 server-data
chown 1000:1000 server-files

1000:1000 represent the user and the group of the LinuxGSM_ user that run server in the image.

⁠Bridge networking

⁠Docker command

docker run -d --name project-zomboid \
              -e SERVER_NAME="pzserver" \
              -e ADMIN_PASSWORD="pzserver-password" \
              -v $(pwd)/server-data:/server-data \
              -p 8766:8766/udp \
              -p 8767:8767/udp \
              -p 16261:16261/udp \
              -p 16262-16272:16262-16272 \
              -p 27015:27015 \
              afey/zomboid

⁠Docker Compose

Alternatively, you could use Docker Compose with this docker-compose.yml file:

version: "3.7"

services:
  project-zomboid:
    image: afey/zomboid
    restart: unless-stopped
    environment:
      SERVER_NAME: "pzserver"
      ADMIN_PASSWORD: "pzserver-password"
    ports:
      - "8766:8766/udp"
      - "8767:8767/udp"
      - "16261:16261/udp"
      - "16262-16272:16262-16272"
      - "27015:27015"
    volumes:
      - ./server-data:/server-data

After creating this file, launch the server with docker-compose up.

⁠Host networking

⁠Docker command

docker run -d --name project-zomboid \
              --network=host \
              -e SERVER_NAME="pzserver" \
              -e ADMIN_PASSWORD="pzserver-password" \
              -v $(pwd)/server-data:/server-data \
              afey/zomboid

⁠Docker Compose

Alternatively, you could use Docker Compose with this docker-compose.yml file:

version: "3.7"

services:
  project-zomboid:
    image: afey/zomboid
    restart: unless-stopped
    environment:
      SERVER_NAME: "pzserver"
      ADMIN_PASSWORD: "pzserver-password"
    network_mode: host
    volumes:
      - ./server-data:/server-data

After creating this file, launch the server with docker-compose up.

⁠Specifying IP address

In this network mode, you could specify the IP address of the host instead of letting the program do it automatically.

In the command line, add the parameter -e LGSM_SERVER_CONFIG='ip="xx.xx.xx.xx"'.

In the docker compose file, add this environment variable:

LGSM_SERVER_CONFIG: |
  ip="xx.xx.xx.xx"

⁠After starting

Once you have run the docker for the first time, you can edit your config file in your mapped directory /server-data/Server/$SERVER_NAME.ini. When it's done, restart your server.

Some of options are not used in these two examples. Look below if you want to adjust your settings.

⁠Variables

• STEAM_PORT_1 Steam port 1 (default: 8766)
• STEAM_PORT_2 Steam port 2 (default: 8767)
• RCON_PORT RCON port (default: 27015)
• RCON_PASSWORD RCON password
• SERVER_NAME Name of your server (for db & ini file). Warning: don't use special characters or spaces.
• SERVER_PASSWORD Password of your server used to connect to it
• SERVER_PUBLIC_NAME Public name of your server
• SERVER_PUBLIC_DESC Public description of your server
• SERVER_BRANCH Name of the beta branch
• SERVER_BETA_PASSWORD Password for the beta branch
• ADMIN_PASSWORD Admin password on your server
• SERVER_PORT Game server port
• PLAYER_PORTS Game ports to allow player to contact the server (by default : 16262-16272 to allow 10 players)

STEAM_PORT_1, STEAM_PORT_2, RCON_PORT, RCON_PASSWORD, SERVER_PASSWORD, SERVER_PUBLIC_NAME, SERVER_PUBLIC_DESC and SERVER_PORT are optional if you have access to the file /server-data/Server/$SERVER_NAME.ini where the values are.

SERVER_BRANCH, SERVER_BETA_PASSWORD and ADMIN_PASSWORD are not used if these values are set by LGSM_COMMON_CONFIG, LGSM_COMMON_CONFIG_FILE, LGSM_SERVER_CONFIG or LGSM_SERVER_CONFIG_FILE. These 4 variables from cyrale/linuxgsm⁠ can override default settings from LinuxGSM_: _default.cfg⁠.

⁠Volumes

• /server-data Data directory of the server. Contains db, config files...
• /server-files Application dir of the server.

⁠Expose

• 8766 Steam port 1 (udp)
• 8767 Steam port 2 (udp)
• 27015 RCON
• 16261 Game server (udp)
• 16262-16XXX Clients slots

You need to bind X ports for client connection. (Example: If you have 10 slots, you need to put -p 16262-16272:16262-16272, if you have 100 slots, you need to put -p 16262-16362:16262-16362).

⁠Questions?

Check out the reddit post: https://www.reddit.com/r/projectzomboid/comments/reemg5/b41_mp_dedicated_server_working_docker_image/⁠

⁠Latest changes

• Removed -e SERVER_BRANCH="..." from run parameters to go back to the stable branch

⁠CREDITS

This image was originally created by Cyrale, thank you for your effort. (https://github.com/cyrale⁠)

I just took his images and updated them, because he stopped maintaining them.