Upgrade DTR

Estimated reading time: 1 minute

These are the docs for DTR version 2.1

To select a different version, use the selector below.

The first step in upgrading to a new minor version or patch release of DTR 2.0, is ensuring you’re running DTR 2.0. If that’s not the case, start by upgrading your installation to version 2.0.0, and then upgrade to the latest version available.

There is no downtime when upgrading an highly-available DTR cluster. If your DTR deployment has a single replica, schedule the upgrade to take place outside business peak hours to ensure the impact on your business is close to none.


Before performing any upgrade it’s important to backup. See docker/dtr backup.

Step 1. Upgrade DTR to 2.0

Make sure you’re running DTR 2.0. If that’s not the case, upgrade your installation to the 2.0 version.

Step 2. Upgrade DTR

To upgrade DTR you use the upgrade command.

  1. Download a UCP client bundle.

    Having a UCP client bundle allows you to run Docker commands on a UCP cluster. Download a UCP client bundle and set up your CLI client to use it.

  2. Pull the latest docker/dtr image.

    $ docker pull docker/dtr:<version>

    If the node you’re upgrading doesn’t have access to the internet, you can use a machine with internet connection to pull all the DTR images.

  3. Run the upgrade command.

    The upgrade command upgrades all DTR replicas that are part of your cluster:

    $ docker run -it --rm \
      docker/dtr:<version> upgrade \

    By default the upgrade command runs in interactive mode and prompts you for any necessary information. You can also check the reference documentation for other existing flags.

Where to go next

docker, dtr, upgrade, install