https://github.com/zicstardust/project-zomboid-dedicated-server
Project Zomboid dedicated server container with auto download of workshop mods for non-steam servers
https://github.com/zicstardust/project-zomboid-dedicated-server
container dedicated-server docker game gameserver podman projectzomboid
Last synced: 3 months ago
JSON representation
Project Zomboid dedicated server container with auto download of workshop mods for non-steam servers
- Host: GitHub
- URL: https://github.com/zicstardust/project-zomboid-dedicated-server
- Owner: zicstardust
- Created: 2025-07-27T16:01:17.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2026-03-20T23:53:10.000Z (4 months ago)
- Last Synced: 2026-03-21T11:43:34.172Z (4 months ago)
- Topics: container, dedicated-server, docker, game, gameserver, podman, projectzomboid
- Language: Shell
- Homepage: https://hub.docker.com/r/zicstardust/project-zomboid-dedicated-server
- Size: 104 KB
- Stars: 4
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Project Zomboid Dedicated Server
Project Zomboid dedicated server container with auto download of workshop mods for non-steam servers
[GitHub](https://github.com/zicstardust/project-zomboid-dedicated-server)
## Container
### Tags
| Tag | Architecture | Description |
| :----: | :----: | :----: |
| [`latest`](https://github.com/zicstardust/project-zomboid-dedicated-server/blob/main/dockerfile) | amd64 | Dedicated Server |
### Registries
| Registry | Full image name | Description |
| :----: | :----: | :----: |
| [`docker.io`](https://hub.docker.com/r/zicstardust/project-zomboid-dedicated-server) | `docker.io/zicstardust/project-zomboid-dedicated-server` | Docker Hub |
| [`ghcr.io`](https://github.com/zicstardust/project-zomboid-dedicated-server/pkgs/container/project-zomboid-dedicated-server) | `ghcr.io/zicstardust/project-zomboid-dedicated-server` | GitHub |
## Usage
### Compose
``` yml
services:
pzserver:
container_name: project-zomboid-dedicated-server
image: docker.io/zicstardust/project-zomboid-dedicated-server:latest
environment:
TZ: America/New_York
ports:
- 16261:16261/udp #Default_Port
#- 16262:16262/udp #Direct Connection
#- 27015:27015 #Rcon port (IMPORTANT: set RCONPassword in server.ini)
volumes:
- /path/to/data:/data
- /path/to/cache:/cache #Opcional: Download cache
```
## Environment variables
| variables | Function | Default | Exemple/Info
| :----: | --- | :----: | --- |
| `TZ` | Set Timezone | | |
| `PUID` | Set UID | 1000 | |
| `PGID` | Set GID | 1000 | |
| `BUILD` | Set build server version | stable | [Look at the set build section](#set-build) |
| `SERVER_NAME` | Set server name | server | |
| `ADMIN_USERNAME` | Set admin username | admin | |
| `ADMIN_PASSWORD` | Set admin password | `generate random password` | Random password can be viewed in container log |
| `STEAM` | set `false` to join non-steam players | true |
| `MAX_RAM` | set max ram to JVM | 8g | 8g = 8 gigabytes
2048m = 2048 megabytes |
| `LANGUAGE` | set server language | en | [Look at the supported server languages section](#supported-server-languages) |
| `UPDATE_JRE` | Update default JRE (experimental)| false | |
| `DISABLE_MOD_DOWNLOADER` | Disable auto mods downloader for non-steam server | false | [Look at the set Auto download mods for non-steam server section](#auto-download-mods-for-non-steam-server) |
| `DISABLE_CACHE` | Disable download cache | false | |
## Set BUILD
| Value | Description |
| :----: | --- |
| `unstable` | Last Unstable Server |
| `outdatedunstable` | Unstable fallback for rollbacks and prior saves |
| `stable` | Last Stable Server |
## Supported server languages
| Value | Language name |
| :----: | --- |
| `ar` | Espanol (AR) |
| `ca` | Catalan |
| `ch` | Traditional Chinese |
| `cn` | Simplified Chinese |
| `cs` | Czech |
| `da` | Danish |
| `de` | Deutsch |
| `en` | English |
| `es` | Espanol (ES) |
| `fi` | Finnish |
| `fr` | Francais |
| `hu` | Hungarian |
| `id` | Indonesia |
| `it` | Italiano |
| `jp` | Japanese |
| `ko` | Korean |
| `nl` | Nederlands |
| `no` | Norsk |
| `ph` | Tagalog |
| `pl` | Polish |
| `pt` | Portugese |
| `ptbr` | Brazilian Portugese |
| `ro` | Romanian |
| `ru` | Russian |
| `th` | Thai |
| `tr` | Turkish |
| `ua` | Ukrainian |
## Auto download mods for non-steam server
If the `STEAM` environment variable is set to `false` and you have mods in the `WorkshopItems` key in **/data/Zomboid/Server/.ini**.
Mods in the `WorkshopItems` key will automatically be downloaded and will replace all files in the **/data/Zomboid/mods/** directory.
To disable automatic mod downloads, set the `DISABLE_MOD_DOWNLOADER` environment variable to `true`.
For Steam server (`STEAM=true`), mod downloader will not run.