v1.3.1

What's Changed

• SSH Client is now integrated. This removes the restrictions that OpenSSH placed on the container (requiring a user), which caused conflicts with some setups.
  • This update requires a recent version of itzg's server container. 2024.4.0 or later when using Java, or a recent 'latest' when using Bedrock (from after March 12, 2024).
  • You may need to pull a newer version of the server container if you find your SSH connection stops working after this update.
• The configuration and backup directories can now be separate.
  • By default, /config is used for configuration, and /data is used for backups. If either doesn't exist, it will fall back to /backups like previous versions.
• Releases now get their own tags in docker, making it easier to lock to a specific release if needed.

Full Changelog: v1.3.0...v1.3.1

v1.3.0

SSH and RCON Support

Docker has been the only way to communicate with the Minecraft container up to this point. Now, you can use SSH or RCON to control the minecraft server and get clean backups. Updated documentation is on the Wiki. itzg's latest Java and Bedrock containers have SSH support that can be enabled with ENABLE_SSH. Any Java Minecraft container should be configurable to use RCON, although the documentation assumes itzg's Java container.

v1.2.2

• Fixes to prevent partial backups being kept around.
• Fixes to avoid multiple backups from happening at the same time.
• Errors encountered when starting the service are better reported.
• Better and more logging to make diagnosing issues easier.
• Updates to Swift 5.6.2

v1.2.1

• Fixes a regression where trimming backups down to a single daily stopped working with 1.2.0
• Logic has been added to try to detect when a crash occurs during a backup, and clean up the state of the server so it can save to disk properly.
• Partial backups will now end with “.part” until they are complete.
• Upgrades to Swift 5.5.3
• Some code cleanup to reduce the number of places the code can crash.

v1.2.0

• Added support for backing up additional folders in the server as “extras”.
• Fix for not Java world names not showing up in the logs.

v1.1.4

• Backtraces are now captured during a crash or forced exit.
• Priority of the backup task has been lowered to lessen interference with Java servers.

v1.1.2

• More forcefully check for write permissions to the backup folder on start
• Check to make sure all the world folders exist on start, rather than waiting for a failed backup
• When backing up multiple servers or worlds, if one fails, it will still attempt to backup the others
• Service will more reliably be marked as unhealthy when a backing up of a single world fails
• All logs are now sent to stderr

v1.1.1

• Many errors now have descriptive text rather than simple error numbers. So no more “ContainerError 1” or “WorldError 2” type errors.
• Docker permission errors are now explicitly checked for, and reported properly to the user.
• A couple more specific errors related to worlds and world paths have been added.

v1.1.0 - Jan 7th, 2021

• Updated to Swift 5.5.2 compiler.
• Converted to a service instead of a script running a tool in a loop. This enables the new scheduler features.
• Java containers can now be backed up, using the new containers settings in the configuration file.
• A linux/arm64 container is also provided for Java servers running on modern ARM devices.
• Configuration parsing now supports YAML format, and defaults to 'config.yml'. For compatibility, 'config.json' will be checked as a fallback.
• Configuration file now has a schedule section which replaces the environment variables.
  • interval is the same as before.
  • startupDelay delays the first backup by the interval given, instead of running it on startup.
  • daily performs a single daily backup, mutually exclusive with interval.
  • onPlayerLogin performs a backup whenever a player logs in.
  • onPlayerLogout performs a backup whenever a player logs out.
  • onLastLogout performs a backup whenever the last player logs out.
  • minInterval throttles event/interval backups to a maximum of one during the minimum interval (i.e. 4h means one backup every 4h maximum).
• Logging is now less verbose. There is a loggingLevel option in the configuration to make it verbose again for diagnostic purposes.

The following has been deprecated. They are still currently working today, but may no longer work at some unknown point in the future.

• DEPRECATED: The "BACKUP_INTERVAL" environment variable is now part of the configuration file.
• DEPRECATED: The "servers" settings in the configuration file is now "containers" with support for Bedrock and Java.
• DEPRECATED: JSON configuration files have been deprecated in favor of YAML configuration files.

v1.0.3 - Dec 21st, 2021

• Updated to Swift 5.5 compiler.
• The property "tty: true" is no longer required on the server container.
• New "ownership" configuration for the backup allows changing the owner, group, and permissions on backups written. Changing the owner and group requires running as root, which isn't recommended. Trimming also may not work properly if the backup tool loses write access. Use with caution.

(Original Docker Changes: https://github.com/Kaiede/docker-minecraft-bedrock-backup/tree/v1.0.3)