docs/reference/ucp/3.2/cli/upgrade.md

title	description	keywords
docker/ucp upgrade	Upgrade the UCP components on this node	ucp, cli, upgrade

{% include enterprise_label_shortform.md %}

Upgrade the UCP cluster.

Usage

 docker container run --rm -it \
        --name ucp \
        -v /var/run/docker.sock:/var/run/docker.sock \
        docker/ucp \
        upgrade [command options]

Description

This command upgrades the UCP running on this cluster.

Before performing an upgrade, you should perform a backup by using the backup command.

After upgrading UCP, go to the UCP web interface and confirm each node is healthy and that all nodes have been upgraded successfully.

Options

Option	Description
--debug, D	Enable debug mode
--jsonlog	Produce json formatted output for easier parsing
--interactive, i	Run in interactive mode and prompt for configuration values
--admin-password value	The UCP administrator password
--admin-username value	The UCP administrator username
--force-minimums	Force the install/upgrade even if the system does not meet the minimum requirements
--host-address value	Override the previously configured host address with this IP or network interface
--id	The ID of the UCP instance to upgrade
--manual-worker-upgrade	Whether to manually upgrade worker nodes. Defaults to false
--pull	Pull UCP images: always, when missing, or never
--registry-password value	Password to use when pulling images
--registry-username value	Username to use when pulling images