Skip to content
Documentation
[05]Operating

Updating safely

How to read a changelog for risk, when a maintenance window is genuinely required, and how to roll back.

3 minute read

Breaking changes are flagged before release. A changelog entry that requires a maintenance window says so explicitly — you should never discover that from your players.

Reading a changelog for risk

  • 01A major version bump means tuning or persistence may not carry over. Read the entry in full.
  • 02DEL and SEC entries always deserve reading. DEL removes something you may depend on.
  • 03A minor or patch bump with only FIX entries is safe to apply on a normal restart.

Rolling back

Every previous version stays available from your account indefinitely. Roll back by deploying the older package — but note that a rollback across a major version may not be able to read persistence written by the newer one.