Crashes & startup failures
This guide covers crashes & startup failures for a Frags4u-managed Project Zomboid dedicated server. It is written for the Frags4u managed environment, so the server identity, allocated resources and network values shown in the Panel take priority over defaults copied from a generic self-hosting guide.
Project Zomboid operational notes • Failure evidence: A bad Workshop/mod combination can fail after the executable launches. Fresh console/log evidence is more useful than process state alone. • Startup: The managed Linux server uses start-server.sh and Frags4u-supplied server name, memory, port and entitlement values. • Mods / frameworks: Project Zomboid uses its native Workshop/mod configuration model. Mod IDs, Workshop items and dependencies need to agree with the current server build. • Updates: Managed dedicated-server updates use SteamCMD and preserve userdata. Review mod compatibility after upstream game updates.
Recommended checks
- Record when the crash/failure occurred and what changed immediately beforehand.
- Check whether the process exits, loops, or remains running but unhealthy.
- Review recent config/mod/framework changes before touching base-game assets.
- Use AI Support from the Technical ticket for approved evidence collection; any bounded repair still requires customer consent.
When to stop changing things If the failure persists after one controlled test, avoid repeated restarts, broad file deletion or unrelated configuration changes. Preserve the newest evidence. A clean process start, a listening game endpoint and a successful client connection are separate signals; record which one is failing.
What to send Support Include the affected server, approximate failure time, exact error text, the last change made and whether the problem affects startup, connectivity, performance, updates or mods. Technical tickets remain bound to the selected game server so staff and AI Support can inspect the correct managed context rather than guessing.
Backups and recovery Before destructive maintenance, keep a verified recovery point. For Project Zomboid, the persistent save/world and configuration areas described above should be treated separately from replaceable base-game assets. Do not use a wipe, reinstall or deletion of runtime files as a first troubleshooting step.
Frags4u AI Support safety boundary AI Support can only use approved typed support actions inside the customer's server boundary. It has no root, sudo, general shell, SSH or node-administration access. Any bounded repair requires customer consent, creates a protected snapshot first, remains limited by the existing remediation policy, and is followed by restart/post-repair verification where a restart is required.