Minecraft Backup
github.com
- Free plan
- Linux
- Self-hosted
What Minecraft Backup is
Minecraft Backup is a free script for backing up world folders from Minecraft servers running on Linux. It can create tar files or use the restic backup backend, and supports servers managed with screen or tmux, RCON, or Docker RCON. The script works with vanilla servers without plugins and can post backup status messages in Minecraft chat. Cron can schedule backups; the README gives an hourly example. For older backups, users can select no deletion, sequential deletion of the oldest backup, or thin retention. Thin retention keeps the latest 24 hourly and 30 daily backups, then uses remaining space for weekly backups. Installation requires tar and a compression program, with gzip as the default; RCON use also requires xxd. The project recommends RCON as the safest connection because it waits for the server to confirm saving is complete. A consistency risk remains: player data can get out of sync with world data during backups, potentially duplicating or losing items. The README also warns that Minecraft bug MC-217729 can cause a backup to fail.
Who it suits
Minecraft Backup suits administrators running Minecraft servers on Linux who need scheduled backups of world folders. It is intended for users comfortable with server management and the listed dependencies.
Good to know, and what to watch
- Works with vanilla servers without plugins.
- Supports tar files and the restic backup backend.
- Can schedule backups with cron.
- Offers thin, sequential, or disabled old-backup deletion.
- Can report backup status in Minecraft chat.
- Player and world data can become inconsistent during backups.
- Requires tar and a compression program; RCON also needs xxd.
- Minecraft bug MC-217729 can cause a backup to fail.
Plans
Every plan and priceFree
Free plan
Getting started
- Download backup.sh from the latest GitHub release
- Install tar and the chosen compression program
- Install xxd if using RCON
- Configure the script for screen, tmux, RCON, or Docker RCON
- Set retention to thin, sequential deletion, or no deletion
- Schedule the script with cron
- Restore tar archives with tar or restic backups with restic restore
Limits to check
Backups cover Minecraft world folders, with full-backup restoration rather than finer-grained restore options. Player data may fall out of sync with world data, and MC-217729 can cause a backup to fail.
The verdict
Minecraft Backup offers configurable scheduled world backups for Linux servers, with several connection and retention choices. The documented consistency risk and possible bug-related failure are important to consider before relying on a backup.
Questions people ask
What does Minecraft Backup cost?
It is free, with a listed plan price of free.
Which systems does it support?
The script targets Minecraft servers running on Linux and can be used in self-hosted setups.
Does it require Minecraft plugins?
No. It works with vanilla Minecraft servers without plugins.
How are old backups handled?
You can keep all backups, delete the oldest sequentially, or use thin retention: 24 hourly, 30 daily, then weekly backups.
How can backups be restored?
Decompress and extract tar backups with tar, or restore restic backups with restic restore.
Who maintains the project?
The repository owner and maintainer is Nicolas Chan, whose profile lists San Francisco.
What the maker publishes
- Backup formats
- It supports tar files and the restic backup backend. source
- Backup formats
- It supports tar files and the restic backup backend. source
- Chat status
- It can print backup status messages in Minecraft chat. source
- Chat status
- It can print backup status messages to Minecraft chat. source
- Consistency caveat
- Player data can become out of sync with world data during backups, which may duplicate or lose items. source
- Consistency limitation
- Player data can become out of sync with world data during backups, potentially duplicating or losing items; the README recommends RCON as the safest connection method. source
- Dependencies
- The system needs tar and the chosen compression tool; RCON usage also requires xxd. source
- Docker
- The README documents running the backup script in Docker and using it with the itzg/docker-minecraft-server container and RCON CLI. source
- Download
- The README instructs users to download backup.sh from the latest GitHub release. source
- License
- The repository identifies its license as MIT. source
- License
- The repository identifies its license as the MIT License. source
- Maintainer
- The GitHub profile names the maintainer Nicolas Chan and lists San Francisco. source
- Maker
- The GitHub profile identifies the repository owner as Nicolas Chan and lists San Francisco. source
- Minecraft limitation
- The README warns that Minecraft bug MC-217729 can cause the server to save the world after save-off and potentially make a backup fail. source
- Old backup deletion
- Its deletion options include thin retention, sequential deletion, or no deletion; thin keeps the last 24 hourly and 30 daily backups, then uses remaining space for weekly backups. source
- Purpose
- Minecraft Backup is a backup script for Minecraft servers running on Linux. source
- Purpose
- Minecraft Backup is a script for backing up Minecraft server worlds on Linux. source
- RCON recommendation
- The README recommends RCON for the safest backups because it waits for the server to confirm save completion. source
- Requirements
- Installation requires tar and the chosen compression program, with gzip as the default; RCON use also requires xxd. source
- Restore guidance
- Tar backups can be decompressed and extracted with tar, while restic backups can be restored with restic restore. source
- Retention
- It can thin old backups by keeping the last 24 hourly and 30 daily backups, then using remaining space for weekly backups, or delete the oldest backup sequentially. source
- Scheduling
- The README gives a cron example for running hourly backups. source
- Scheduling
- The README shows how to automate recurring backups with cron. source
- Server access
- It supports Minecraft servers running in screen or tmux, or with RCON enabled. source
Checked against the maker's pages on 3 Oct 2026.