Skip to main content

​
Automatic Updates

SimpleCloud features a fully automatic update system. When we release a new version, your installation automatically downloads and applies the update - no action required on your part.
  • Updates are downloaded automatically in the background
  • Your configuration files are preserved during updates
  • Components restart without downtime - your servers continue running
  • Players remain connected without interruption
This hands-off approach ensures you’re always running the latest version without manual intervention.

​
Zero-Downtime Updates

SimpleCloud supports rolling updates for all components. When an update is applied:
  • Components are updated and restarted one by one
  • Your Minecraft servers continue running throughout the update process
  • Players remain connected without interruption
  • The update completes automatically in the background

​
Manual Updates

If you prefer to trigger updates manually, use the upgrade command: 
simplecloud upgrade
With no targets, this upgrades the CLI and all installed components. You can also upgrade specific targets: 
simplecloud upgrade [targets..]
Targets can be cli, component IDs, or component version pins such as serverhost@1.2.3.
simplecloud update still works as an alias for simplecloud upgrade.

​
Updating the CLI

The CLI itself can be updated separately using: 
simplecloud upgrade cli
This command checks for a newer CLI version, downloads it, and replaces your current installation. Use simplecloud upgrade cli --cli-force to reinstall the latest CLI even when it is already current.
The CLI will automatically prompt you to update if it is more than 5 versions behind the latest release.