+++
title = "upgrade"
description = "Upgrade UCP controller"
[menu.main]
identifier = "ucp_upgrade"
parent = "ucp_ref"
+++

# upgrade

```
docker run --rm -it \
      --name ucp \
      -v /var/run/docker.sock:/var/run/docker.sock \
      docker/ucp \
      upgrade [OPTIONS]
```

## Description

Upgrades UCP on a node. When upgrading UCP, you must run the `upgrade` command
against every server and node running Docker Engine in your cluster. You should
upgrade your controller and replica nodes first, followed by your compute nodes.  
Depending on the upgrade path for your version of UCP, you may also need to
upgrade Docker Engine. You can also choose to upgrade Docker Engine simply
because a new version is available.  Always upgrade a node`s Docker Engine
installation before upgrading its UCP installation.

After upgrading each node, confirm the node is present in the UCP console
before proceeding to the next node.

## Options

| Option | Description |
|-----------------------------|----------------------------------------------------------------------------------|
| ` --debug`, `-D` | Enable debug. |
| ` --jsonlog` | Produce json formatted output for easier parsing. |
| ` --interactive`, `-i` | Enable interactive mode.,You will be prompted to enter all required information. |
| ` --image-version "latest"` | Select a specific UCP version. |
| ` --id` | The ID of the UCP instance to upgrade. |
| ` --pull "always"` | Specify image pull behavior (`always`, when `missing`, or `never`). |