# ProjectZomboidReporter-Ingester

ProjectZomboidReporter-Ingester is the data-collection component of the Zomboid Server Stats Reporter project that reads statistics from a Project Zomboid dedicated server's files and uploads them to a MySQL database. It is open source and self-hosted, installable on Unraid and Docker Hub.

Canonical page: https://ourlocalhost.com/app/2469/projectzomboidreporter-ingester

## Description

ProjectZomboidReporter-Ingester is the data-collection component of the Zomboid Server Stats Reporter project that reads statistics from a Project Zomboid dedicated server's files and uploads them to a MySQL database every 5 minutes, so the project's API and web frontend can display server, player, and configuration data.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

17/100 (Low), based on 4 of 5 factors.
- Maintained: 0 (last commit 1657 days ago)
- Popular: 28 (24 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 20 (1 serious finding, 19 minor, tests)

## Security check

1 serious finding: Uses @babel/traverse 7.16.8, which has a known critical vulnerability.
Automated checks on commit 59df6e5, 16 Nov 2026. Not an audit.

## Links

- GitHub: https://github.com/ChrisAshtear/Zomboid-Server-Stats-Reporter
- Unraid: https://ca.unraid.net/apps/projectzomboidreporter-ingester-0m3wqpu1m6enlq?q=ProjectZomboidReporter-Ingester
- Docker Hub: https://hub.docker.com/r/chrisashtear/zomboid-reporter/

## Common questions

### What should I do if Docker services cannot write to the Project Zomboid server folder?

Run chmod 777 -R on the ./z server folder created by docker-compose. This allows the services to write to the server files.

### Why does the reporter not complete until after a player joins the server?

The reporter will not complete successfully until someone has been in the game and map_t.bin has been created. That file can take about five minutes, roughly a full save interval, to appear.

### How does the included NGINX service expose the frontend and backend?

NGINX combines the frontend and backend into one site. The root address serves the frontend, while the /api path routes to the backend.

### How often does the reporter collect data from the server files?

The PHP reporter runs on a timer roughly every five minutes. It scrapes the Project Zomboid save files and sends the data to the SQL database.

---
Source: Our Local Host (https://ourlocalhost.com/app/2469/projectzomboidreporter-ingester), the self-hosted and open-source app directory.
