> ## Documentation Index
> Fetch the complete documentation index at: https://new-docs.simplecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Updates

> Keep your SimpleCloud installation up to date with our built-in update mechanisms

## 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:

```bash theme={null}
simplecloud upgrade
```

With no targets, this upgrades the CLI and all installed components. You can also upgrade specific targets:

```bash theme={null}
simplecloud upgrade [targets..]
```

Targets can be `cli`, component IDs, or component version pins such as `serverhost@1.2.3`.

<Note>
  `simplecloud update` still works as an alias for `simplecloud upgrade`.
</Note>

## Updating the CLI

The CLI itself can be updated separately using:

```bash theme={null}
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.

<Note>
  The CLI will automatically prompt you to update if it is more than 5 versions behind the latest release.
</Note>
