https://github.com/lafayettegabe/docker-zomboid-server
🧟♂️ | Dockerized Project Zomboid Server Setup with Mod Support and Config Management
https://github.com/lafayettegabe/docker-zomboid-server
game-hosting game-server zomboid zomboid-server
Last synced: over 1 year ago
JSON representation
🧟♂️ | Dockerized Project Zomboid Server Setup with Mod Support and Config Management
- Host: GitHub
- URL: https://github.com/lafayettegabe/docker-zomboid-server
- Owner: lafayettegabe
- License: mit
- Created: 2024-12-22T19:56:04.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-24T03:43:10.000Z (over 1 year ago)
- Last Synced: 2025-02-15T13:37:18.672Z (over 1 year ago)
- Topics: game-hosting, game-server, zomboid, zomboid-server
- Language: Shell
- Homepage: https://hub.docker.com/repository/docker/lafayettegabe/docker-zomboid-server
- Size: 14.6 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Project Zomboid Dedicated Server Automation
## Introduction
This project provides a fully automated setup for running a Project Zomboid dedicated server using a prebuilt Docker image. It simplifies server deployment, configuration, and mod management.
---
## Quick Start
1. Pull the Docker image from Docker Hub:
```bash
docker pull lafayettegabe/docker-zomboid-server:latest
```
2. Create a `docker-compose.yml` file with the following content:
```yml
services:
zomboid-server:
image: lafayettegabe/docker-zomboid-server:latest
environment:
- SERVER_NAME=DockerServer
- SERVER_DESCRIPTION=A description for the server!
- SERVER_PASSWORD=password
- SERVER_MODS_COLLECTION_URL=https://steamcommunity.com/sharedfiles/filedetails/?id=3388931496
ports:
- "16261:16261/udp"
- "16262:16262/udp"
restart: unless-stopped
```
3. Start the server:
```bash
docker-compose up -d
```
---
## Configuration
You can customize the server by setting the following environment variables in `docker-compose.yml`:
| Variable | Description | Default Value |
|----------------------------|-----------------------------------------------|-----------------------------|
| `SERVER_NAME` | Public name of the server | `DockerServer` |
| `SERVER_DESCRIPTION` | Description displayed in the server browser | `A description for the server!` |
| `SERVER_PASSWORD` | Password to join the server | `password` |
| `SERVER_MODS_COLLECTION_URL` | URL to a Steam Workshop collection containing mods | `None` |
---
## Ports
Ensure the following ports are open on your host machine:
- **16261/udp**: Server connection.
- **16262/udp**: Game connection.
---
## License
This project is distributed under the MIT License.