Uninstall UCP

Estimated reading time: 1 minute

Docker UCP is designed to scale as your applications grow in size and usage. You can add and remove nodes from the cluster, to make it scale to your needs.

You can also uninstall Docker Universal Control plane from your cluster. In this case the UCP services are stopped and removed, but your Docker Engines will continue running in swarm mode. You applications will continue running normally.

After you uninstall UCP from the cluster, you’ll no longer be able to enforce role-based access control to the cluster, or have a centralized way to monitor and manage the cluster.

WARNING: After uninstalling UCP from the cluster, you will no longer be able to join new nodes using docker swarm join unless you reinstall UCP.

To uninstall UCP, log in into a manager node using ssh, and run:

$ docker run --rm -it \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --name ucp \
  docker/ucp uninstall-ucp --interactive

This runs the uninstall command in interactive mode, so that you are prompted for any necessary configuration values. Check the reference documentation to learn the options available in the uninstall-ucp command.

Where to go next

chat icon Feedback? Suggestions? Can't find something in the docs?
Edit this page Request docs changes Get support
Rate this page: