Minecraft — Runbook

Routine Tasks

Restart services

ssh [email protected] "systemctl restart minecraft"
ssh [email protected] "systemctl restart playit"

---

Logs

Log	Contents	Location	Loki query	Format
Minecraft server	Player connections, world events, errors, crashes	LXC 109 journald	{job="minecraft", unit="minecraft.service"}	Plain text
Playit tunnel	Tunnel status, connection events	LXC 109 journald	{job="minecraft", unit="playit.service"}	Plain text

Notes: - All systemd units on LXC 109 are shipped via Alloy journal tailing - SSH fallback: ssh [email protected] "journalctl -u minecraft -f" / journalctl -u playit -f

---

Troubleshooting

Players can't connect from outside

1. Check playit service is running: systemctl status playit
2. Check playit logs for tunnel errors: journalctl -u playit -n 50
3. If the tunnel agent lost its claim, the secret key stored in Vault may be stale — redo the playit.gg first-time setup to reclaim

Server not starting

1. Check Minecraft service logs: journalctl -u minecraft -n 100
2. Common cause: Java memory settings — check ExecStart in the systemd unit for -Xmx / -Xms values vs available RAM on LXC 109