Skip to content

Commit 7eda3e9

Browse files
committed
Create README.md
1 parent 6698c7e commit 7eda3e9

1 file changed

Lines changed: 43 additions & 0 deletions

File tree

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
# Project Zomboid Dedicated Server (Build 42)
2+
3+
## Connecting
4+
5+
- **Address:** `zomboid.vanillax.me`
6+
- **Port:** `16261`
7+
- **Password:** Stored in 1Password (`project-zomboid` > `server-password`)
8+
9+
From local network, you can also connect via `192.168.10.51:16261`.
10+
11+
## Architecture
12+
13+
- **Image:** `danixu86/project-zomboid-dedicated-server:latest-unstable`
14+
- **Branch:** Build 42 multiplayer (unstable)
15+
- **Service:** LoadBalancer on `192.168.10.51` (UDP 16261-16262, TCP 27015)
16+
- **Storage:** 20Gi Longhorn PVC with daily VolSync backups
17+
- **Memory:** 2-10GB JVM, 12GB container limit
18+
19+
## Networking
20+
21+
This is a UDP game server — no Gateway API or Cloudflare proxy.
22+
23+
- **Cloudflare:** DNS-only A record (grey cloud) pointing `zomboid.vanillax.me` to public IP
24+
- **Firewalla:** Port forward UDP 16261, 16262 and TCP 27015 to `192.168.10.51`
25+
26+
## Secrets (1Password)
27+
28+
Item `project-zomboid` in `homelab-prod` vault:
29+
30+
| Field | Purpose |
31+
|-------|---------|
32+
| `admin-username` | In-game admin login |
33+
| `admin-password` | In-game admin password |
34+
| `server-password` | Password players need to join |
35+
| `rcon-password` | RCON remote admin password |
36+
37+
## First Boot
38+
39+
First boot takes 5-10 minutes as the server loads all B42 assets and generates the world. The `sed` warnings about missing `.ini` are normal on first boot — the file is created after the JVM starts.
40+
41+
## Server Config
42+
43+
Server config is stored on the PVC at `/home/steam/Zomboid/Server/VanillaX.ini`. Changes to this file persist across restarts.

0 commit comments

Comments
 (0)