Skip to main content

Update the CLI

The CLI tells you when a new version is available but does not update automatically. To install the latest release, run:
The command replaces the CLI with the latest release. It does not restart the serverhost or any Minecraft servers. Run sc --version afterward to confirm the installed version.

Automatic serverhost updates

SimpleCloud automatically assigns the latest release to each serverhost. When the assigned version differs from the installed version, the serverhost downloads the update and restarts itself. The restart affects only the serverhost process. Minecraft servers keep running because they use separate processes. Automatic updates do not update the CLI, Minecraft server software, or plugins. Update those separately.

Update the serverhost now

You normally do not need to update the serverhost yourself. To install an available update immediately, run this command from your SimpleCloud installation directory:
This command updates and restarts the serverhost. Run it during a maintenance window. SimpleCloud asks whether it should also stop the Minecraft servers running on this serverhost, unless you saved this choice earlier.
After the command completes, confirm that the serverhost is running:
If the serverhost does not start, inspect its logs:
Fix the reported problem, then run sc start serverhost to start it again.

Other update options

Use sc upgrade to update the CLI and all installed SimpleCloud components, or sc upgrade serverhost to download only the serverhost update.
These commands do not restart running components. Restart the serverhost when you are ready to use its new version.
To test or roll back a release, download the version you want:
The command does not restart the serverhost. Run sc restart serverhost when you are ready to use the selected version.
If the CLI installation is not writable by your user, run sudo sc upgrade cli. If the installation is damaged but already current, reinstall it with:
When the CLI is several releases behind, it may require an update before other commands can run.