Skip to main content

​
Prerequisites

  1. Visit Docker Documentation.
  2. Navigate to Product Manual → Docker Enterprise.
  3. Select Universal Control Plane → Administration.
  4. In the left menu, click Install and review System Requirements.
Ensure all required network ports are open before proceeding. See Network Ports.

​
System Requirements

​
Software

RequirementDetails
Docker EngineInstalled and running
Linux KernelVersion ≥ 3.10
NetworkStatic IP on the host server

​
Hardware (Minimum)

Node TypeRAMCPUDisk Space (Free)
Manager8 GB2 cores≥ 10 GB
Worker4 GB2 cores≥ 10 GB
The image shows a webpage from Docker documentation detailing the minimum and recommended system requirements for Docker Enterprise, including RAM, CPU, and disk space specifications for manager and worker nodes.
Node RoleRAMCPUDisk Space
Manager (Prod)16 GB4 cores25–100 GB free
Docker Engine is already installed and the host meets these specs, so we’ll skip custom volume configuration (step 3 in the guide).

​
Installation Steps

  1. Pull the UCP image (e.g., version 3.2.6): 
    docker image pull docker/ucp:3.2.6
  2. Run the installer container (replace <node-ip-address> with your manager’s private IP): 
    docker container run --rm -it --name ucp \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker/ucp:3.2.6 install \
  --host-address <node-ip-address> \
  --interactive
  3. When prompted:
    • Enter Admin Username (e.g., yogeshraheja)
    • Set and confirm Admin Password
    • Press Enter if no additional aliases (SANs) are needed

​
Example Installation Output

[root@ucpmanager ~]# docker image pull docker/ucp:3.2.6
3.2.6: Pulling from docker/ucp
4167d3e14976: Pull complete
af325902296c: Pull complete
1c053272dca9: Pull complete

[root@ucpmanager ~]# docker container run --rm -it --name ucp \
> -v /var/run/docker.sock:/var/run/docker.sock \
> docker/ucp:3.2.6 install \
> --host-address 172.31.32.217 \
> --interactive
INFO[0000] Your Docker daemon version 19.03.5, build 2ee0c57608 ... is compatible with UCP 3.2.6
INFO[0000] Initializing New Docker Swarm
Admin Username: yogeshraheja
Admin Password:
Confirm Admin Password:
WARN[0016] None of the Subject Alternative Names ... ("ucpmanager") ...
You may enter additional aliases (SANs) now or press enter to proceed with the above list.
Additional aliases:
INFO[0019] Checking required ports for connectivity
INFO[0025] Pulling required images... (this may take a while)
INFO[0025] Pulling image: docker/ucp-agent:3.2.6
...
INFO[0043] Step 24 of 35: [Install Kubernetes CNI Plugin]
This will take several minutes as UCP deploys both Swarm and Kubernetes orchestrators.

​
Accessing the UCP Console

  1. Open https://<public-ip> in your browser.
  2. Sign in using your admin credentials.
  3. Upload your Docker Enterprise license (downloadable from your Docker Hub account).
Once logged in, the UCP dashboard displays six main sections:
The image shows a Docker Enterprise Universal Control Plane dashboard, displaying the status of manager and worker nodes, along with CPU, memory, and disk usage statistics.
SectionDescription
AdminManages current admin user and account settings
DashboardCluster overview: node status, Swarm/Kubernetes workloads, resource metrics
Access ControlUser, team, and role-based access management
Shared ResourcesManage nodes, containers, images, networks, and volumes
KubernetesGUI for deploying and monitoring Kubernetes workloads
SwarmGUI for building and scaling Swarm services and stacks
Navigate to Shared Resources → Nodes to view cluster membership. Initially, only the manager node appears.
The image shows a Docker Enterprise Universal Control Plane dashboard with details of a single node, including its status, type, role, address, and resource usage. The sidebar includes options for managing resources like collections, stacks, containers, and nodes.
The Workers count should be zero, confirming no worker nodes have joined.

Watch Video