Uninstall UCP
Estimated reading time: 2 minutesUse the docker/ucp uninstall command, to uninstall Docker Universal Control Plane from a node. This command only removes the UCP containers, and doesn’t affect any other containers.
To see what options are available in the uninstall command, check the uninstall command reference.
To uninstall Docker UCP from a cluster, you need to:
- Uninstall UCP from every node joined in the cluster,
- Uninstall UCP from every controller node, one at a time,
- Restart the Docker engine on all the nodes.
Example
In this example we’ll be running the uninstall command interactively, so that the command prompts for the necessary configuration values. You can also use flags to pass values to the uninstall command.
-
Run the uninstall command.
$ docker run --rm -it \ -v /var/run/docker.sock:/var/run/docker.sock \ --name ucp \ docker/ucp uninstall -i INFO[0000] Were about to uninstall the local components for UCP ID: FEY4:M46O:7OUS:QQA4:HLR3:4HRD:IUTH:LC2W:QPRE:BLYH:UWEM:3TYV Do you want proceed with the uninstall? (y/n): y WARN[0000] We detected a daemon advertisement configuration. Proceed with caution, as the daemon will require a restart. Press ctrl-c to cancel uninstall within 4 seconds. INFO[0004] Removing UCP Containers INFO[0005] Removing UCP images WARN[0006] Configuration updated. You will have to manually restart the docker daemon for the changes to take effect. WARN[0006] Engine discovery configuration removed. You will need to restart the daemon. INFO[0010] Removing UCP volumes
-
List the images remaining on the node.
$ docker images REPOSITORY TAG IMAGE ID CREATED SIZE docker/ucp latest 788bdcfde423 8 days ago 8.239 MB
The uninstall command removes all UCP-related images except the
docker/ucp
image. -
Remove the docker/ucp image.
$ docker rmi docker/ucp Untagged: docker/ucp:latest Deleted: sha256:788bdcfde423b6226b90ac98e6f233b15c0c527779177d7017a4e17db31404c9 Deleted: sha256:dee84053b25f9b3edffb734c842a70313021063cc78d9158c63de109e1b3cb72 Deleted: sha256:93743d5df2362466e2fe116a677ec6a4b0091bd09e889abfc9109047fcfcdebf
-
Restart the Docker daemon.
When you install or join a node, UCP configures the Docker engine on that node for multi-host networking. When uninstalling, the configuration is reverted to its original state, but you need to restart the Docker engine for the configurations to take effect.
As an example, to restart the Docker engine on a Ubuntu distribution:
$ sudo service docker restart
-
Confirm the node was removed from the cluster.
In the UCP web application, confirm the node is no longer listed. It might take a few minutes for UCP to stop listing that node.