Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Minecraft Backup

github.com

  • Free plan
  • Linux
  • Self-hosted
7.2 Club score Visit github.com

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.

Free

Free

Free plan

Getting started

  1. Download backup.sh from the latest GitHub release
  2. Install tar and the chosen compression program
  3. Install xxd if using RCON
  4. Configure the script for screen, tmux, RCON, or Docker RCON
  5. Set retention to thin, sequential deletion, or no deletion
  6. Schedule the script with cron
  7. 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.