WilliamLam.com

  • About
    • About
    • Privacy
  • VMware Cloud Foundation
    • VMware Cloud Foundation 9
  • VKS
  • Homelab
    • Hardware Options
    • Hardware Reviews
    • Lab Deployment Scripts
    • Nested Virtualization
    • Homelab Podcasts
  • VMware Nostalgia
  • Apple
You are here: Home / VMware Cloud Foundation / Quick Tip - Establish trust between VCF 9.0 Installer and VCF Offline Depot w/self-sign TLS certificate

Quick Tip - Establish trust between VCF 9.0 Installer and VCF Offline Depot w/self-sign TLS certificate

08.01.2025 by William Lam // 4 Comments

For lab purposes, when configuring a VCF 9.0 Offline Depot, you can streamline the infrastructure setup by configuring the VCF Installer to use HTTP instead of HTTPS, which is the default configuration from the VCF Installer.

Alternatively, if you decide to use the system default which will expect the VCF Offline Depot to be served over HTTPS, you might be using a self-signed TLS certificate. If you attempt to connect to your offline depot with the VCF Installer, you probably will hit the following error as the TLS certificate is not trusted by the VCF Installer, which is expected.


In VCF 5.x, the workaround was to import your TLS certificate chain into SDDC Manager's certificate store which would then allow the trust to be established.

The exact same solution is required for the VCF Installer, but the path to the certificate store has changed.

Step 1 - Copy the TLS certificate chain from your VCF Offline Depot to the VCF Installer appliance. In my example, I have placed it in /root/fullchain.pem

Step 2 - Run the following command to import your certificate into the VCF Installer certificate store (replace the -file and -alias with your own values) and trust the certificate:

keytool -import -trustcacerts -file /root/fullchain.pem -keystore /usr/lib/jvm/openjdk-java17-headless.x86_64/lib/security/cacerts -alias depot.vcf.lab

Note: You will be prompted for a password which will be changeit


Step 3 - We now need to restart the VCF Installer services for the change to go into effect:

echo 'y' | /opt/vmware/vcf/operationsmanager/scripts/cli/sddcmanager_restart_services.sh

Step 4 - Finally, we can now connect to the VCF Offline Depot over HTTPS and we will no longer see the error message!


Once enhancement I would love to see in the future for both the VCF Installer and SDDC Manager is what has already been implemented in VCF Operations Fleet Manager, which allows users to easily trust a self-sign TLS certificate during the connection workflow without having to jump through multiple hoops, something I definitely will be sharing with our PM team.

Categories // VMware Cloud Foundation Tags // VCF 9.0

Comments

  1. *protectedketchup says

    08/13/2025 at 12:26 pm

    Could you attempt "VCF Download Tool Update Manager Download Service (UMDS) Commands" portion of the download tool as well?
    It took me some trial an error to get the sddc managers to sync with the offline depot. Might be good to have as a reference.

    Reply
    • *protectedketchup says

      10/10/2025 at 5:41 am

      Definitely appreciate your blog posts!

      Have you tested syncing the ESXI components with the offline depot and SDDC Manager? Theres another certificate store that gets used when running the esxi component sync to an offline depot.
      CAfile: /etc/pki/tls/certs/ca-bundle.crt
      CApath: /etc/ssl/certs

      ./vcf-download-tool umds run vmware-umds -D

      SDDC and Fleet appliance are connected to an offline depot and download the patches, upgrades and install binaries just fine. But trying to sync .vibs the task fails due to the mentioned cert store not having either the self-signed or enterprise trusted CA's imported to this cert store as well.

      Currently got a support case open to verify proper steps for this since these certs are managed by a different cert utility.

      Reply
      • William Lam says

        10/10/2025 at 8:08 am

        Can toy share SR number?

        Reply
        • William Lam says

          10/10/2025 at 5:02 pm

          Looks like Step 7 is what you need to apply https://williamlam.com/2024/05/creating-an-offline-vmware-cloud-foundation-vcf-depot-for-multiple-vcf-environments.html

          Reply

Thanks for the comment!Cancel reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Search

Thank Author

Author

William is Distinguished Platform Engineering Architect in the VMware Cloud Foundation (VCF) Division at Broadcom. His primary focus is helping customers and partners build, run and operate a modern Private Cloud using the VMware Cloud Foundation (VCF) platform.

Connect

  • Bluesky
  • Email
  • GitHub
  • LinkedIn
  • Mastodon
  • Reddit
  • RSS
  • Twitter
  • Vimeo

Recent

  • Realtek Network Driver for ESXi 11/12/2025
  • Quick Tip - Configure Nested ESX Cores per CPU for Optimal Licensing 11/11/2025
  • Quick Tip - VCF 9.0.1 upgrade files now available on Broadcom Support Portal (BSP) 11/10/2025
  • Auditing ESX DCUI Logins 11/10/2025
  • Capturing Kasa Smart Plug Power Metrics using VCF Operations Management Pack Builder 11/07/2025

Advertisment

Privacy & Cookies: This site uses cookies. By continuing to use this website, you agree to their use.

To find out more, including how to control cookies, see here: Cookie Policy

Copyright WilliamLam.com © 2025

 

Loading Comments...