0 Fork 0

Files

T

Aryan SinghandClaude Fable 5 279d137ce5 Minecraft 26.2 Fabric server stack with CraftDeck management panel

- docker-compose: itzg/minecraft-server (Fabric, offline mode, whitelist
  enforced, Modrinth-managed mods), itzg/mc-backup sidecar, custom dashboard
- Gated auth for offline mode: approve username -> whitelisted with a short
  registration window -> EasyAuth /register + /login; auto-revoke on expiry
- CraftDeck panel (Next.js 16, zero native deps): live console (SSE), players
  & stats, lag diagnostics (server TPS vs player ping via spark), performance
  graphs, Modrinth mod search/manager, backups & restore, sandboxed file
  browser/editor, .env config editor with compose apply, cron schedules,
  Discord alerts, scrypt-hashed panel login
- scripts/setup.sh generates secrets; docs/ covers auth, mods, updating,
  backups, networking (Tailscale), troubleshooting

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-07-10 11:07:07 -05:00

1.9 KiB

Raw Blame History

Backups & restore

What runs automatically

The backup sidecar (itzg/mc-backup) tars the entire server data directory to data/backups/world-<timestamp>.tgz:

flushes the world to disk first (save-all), safe while players are online
interval: BACKUP_INTERVAL in .env (default 24h)
retention: BACKUP_RETENTION_DAYS (default 7) — older tars are pruned
excludes caches and logs

Safety backups are also taken automatically before config applies (when enabled) and world resets.

Manual backup

Panel: Backups page → Back up now
CLI: docker exec mc-backup backup now

Restoring

Panel: Backups page → Restore → type restore. The panel stops the server, extracts the tar over the data directory, and starts the server again. Everything since that backup is lost.

CLI fallback (panel down):

./scripts/restore.sh data/backups/world-20260710-050000.tgz

Off-site copies (recommended)

data/backups/ is just files — sync it anywhere:

# example: nightly rsync to another machine (add to the host's crontab)
0 6 * * * rsync -a --delete /path/to/minecraft/data/backups/ backup-host:/srv/mc-backups/

You can also download any backup from the panel (⬇ button) before risky experiments.

Disaster recovery (new machine)

git clone <repo> minecraft && cd minecraft
./scripts/setup.sh                      # fresh secrets — friends keep their passwords,
                                        # those live in the world data, not in .env
mkdir -p data/backups && cp <your-backup>.tgz data/backups/
docker compose up -d                    # let it initialize once
./scripts/restore.sh data/backups/<your-backup>.tgz

The backup contains the world, mods, configs, and the EasyAuth database, so player registrations survive. Panel state (approval history, metrics) lives in data/dashboard/ — include it in your off-site sync if you want it back too.

1.9 KiB Raw Blame History