Backups

Automated daily backup

A cron job runs scripts/backup-prod.sh every day at 04:00 UTC.

It tars the live world folders and writes to:

/home/minecraft/terminacraft/backups/prod/stable-YYYY-MM-DD.tar.gz

14 backups are kept. The oldest is deleted when a new one is written. Events are logged to logs/events.jsonl and logs/backup.log.

Manual backup

bash /home/minecraft/terminacraft/scripts/backup-prod.sh

Restoring a world

1. Stop the server: sudo systemctl stop minecraft-prod
2. Replace the world folder(s):

   cd /home/minecraft/terminacraft
   rm -rf worlds/stable
   tar -xzf backups/prod/stable-YYYY-MM-DD.tar.gz -C worlds/

3. Start the server: sudo systemctl start minecraft-prod

The live world is at worlds/stable/ and is symlinked into the server directory. The symlink does not need to be recreated after a restore as long as you restore to the same path.

Baseline snapshots

backups/stable_baseline_* are the original world snapshots from VPS setup. These are kept as a permanent fallback and should not be deleted.