Newer
Older
gnexus-book / 10-systems / hosts / minecraft-server.md

owner: gmikcon status: active last_reviewed: 2026-10-25 review_interval: 90d confidence: high

source_of_truth: ssh-host-verified

Minecraft Server (mine)

Vanilla Minecraft server on host mine (192.168.1.160), port 25565.

Service

  • systemd unit: minecraft-server-vanilla.service (user minecraft, WorkingDirectory /home/minecraft/server-vanilla).
  • ExecStart: screen session mc-server running java -Xms4G -Xmx14G -jar server.jar nogui (Java 25).
  • Restart=on-failure. GOTCHA: a plain stop typed into the screen session exits java with non-zero status, systemd counts it as failure and RESPAWNS the server. To stop for real: systemctl stop minecraft-server-vanilla.service, then systemctl reset-failed to clear the failed state.
  • RCON disabled (enable-rcon=false); console access only via the screen session.
  • World data: /home/minecraft/server-vanilla/world. MOTD: GNexus Space.
  • Server auto-pauses when empty for 60s (vanilla pause feature).

Public access (verified 2026-10-25)

  • Public address: minecraft.gnexus.space:25565 (DNS → 51.83.131.93, external VPS). End-to-end MC status ping OK: MOTD A Minecraft Server, version 26.2 (proto 776), max players 40.
  • Path: external VPS → OpenVPN tunnel (client: ovpn VM 192.168.1.150, tun0 10.8.0.2) → nft DNAT on ovpn VM (tun0 tcp 80/443/25565 → 192.168.1.183, SNAT to 192.168.1.150) → nginx stream on internal-proxy-vps (/etc/nginx/stream-conf.d/minecraft.gnexus.space.conf, listen 25565 → 192.168.1.160:25565).
  • Redundant legacy forwarder on the ovpn VM: minecraft-tcp-forward.service (socat, listen 25565 → 192.168.68.218:25565 — mine's second NIC in a libvirt network). It receives no tun0 traffic (PREROUTING DNAT intercepts first) and is harmless; safe to disable if desired (owner decision).

History / observations

  • 2026-10-25 (navi rei): public access verified end-to-end (MC status ping via domain and via 51.83.131.93, plus TCP connect from 3 external check-host.net nodes). No config changes were needed — the earlier "dead mapping" note was stale: the live nginx stream config already pointed at 192.168.1.160.
  • 2026-10-07: stopped by navi rei on owner request (no players online; last player l3iniv4kur4 left 14:59 UTC). Unit left inactive, world saved via graceful stop.
  • Old Forge modded server directory /home/minecraft/server exists with stale logs (Jul 2025) — not the running instance.

No raw credentials are documented here.