Obtaining Cluster Control Manager registry CA certificate for WSL distribution

Last Updated : Mar 27, 2026 |
Prolog information
In an offline air-gap deployment, secure communication with the CCM local Docker registry requires installing the registry's CA certificate within the WSL environment. This procedure extracts the certificate from the CCM registry and installs it in the Docker truststore within WSL.
Before you begin
Ensure the following:
  • You complete the offline deployment setup on the CCM.
  • ChartMuseum and Docker are running on CCM.
  • You have access to the CCM registry host with cust user credentials.
  • The ccm-agn-wsl distribution is running.
  1. Log in to the CCM registry host with cust user credentials.
  2. To retrieve the certificate chain and save it as ca.crt, run openssl s_client -connect <ccm-fqdn>:5010 -showcerts </dev/null | sed -n '/BEGIN CERTIFICATE/,/END CERTIFICATE/p' > ca.crt.
    ADDITIONAL INFORMATION:
    Note:
    The following OpenSSL warning can display after CSP cluster deployment due to internal or self-signed certificates:
    Other:
    Unable to get local issuer certificate / unable to verify the first certificate.
    You can ignore the warning, as the ca.crt certificate generates successfully.
  3. Copy the extracted certificate to C:\avaya\cacerts WSL Windows host folder.
  4. If you are in the ccm-ctl-agn container shell, type exit to return to the WSL distribution shell.
  5. To install the docker certificate in the WSL distribution shell, do the following:
    1. To create the Docker registry certificate directory, run mkdir -p /etc/docker/certs.d/<ccm-fqdn>:5010.
    2. To copy the certificate from Windows folder, run cp /mnt/c/avaya/cacerts/ca.crt /etc/docker/certs.d/<ccm-fqdn>:5010/.
  6. To update the truststore, run update-ca-trust extract.
  7. To restart the Docker service, run systemctl restart docker.
  8. To verify access to the registry, run docker login <ccm-fqdn>:5010.
    ADDITIONAL INFORMATION:
    Note:
    The login is successful, if the CCM registry CA certificate is correctly installed.
Next steps
If login is successful, the CCM registry CA certificate installs correctly and there is secure communication between the CCM registry and the Docker within WSL.